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PREFACE 



This manual describes how to use the iAPX 86,88 Family utilities: 

• LINK86 

• CREF86 

• LIB86 

• LOC86 

• OH86 

These products run on 8086- and 8088-based systems. They are used by program- 
mers developing programs with ASM86, ASM89, PL/M-86, PASCAL-86, 
FORTRAN-86, or any other language translator that produces object code compat- 
ible with the iAPX 86,88 Family of processors. The iAPX 86,88 Family of pro- 
cessors inlcudes 8086, 8088, 8087, and 8089 processor chips. Because the 8086 is the 
first member of this family, this manual uses 8086 generically to represent the entire 
family. 



This manual presumes familiarity with the conventions of the operating system 
under which the iAPX 86,88 utilities are being executed. It also presumes familiarity 
with the basic requirements of individual languages and translators. 

This manual is divided into the following chapters: 

• Chapter 1, Introduction: a summary of the relationship among the utilities and 
basic concepts governing their use 

• Chapter 2, LINK86: how to invoke, use the controls for, and read the printed 
listing from LINK86 

• Chapter 3, CREF86: how to invoke, use the controls for, and read the output 
listing from CREF86 

• Chapter 4, LIB86: how to invoke and use the commands for LIB86 

• Chapter 5, LOC86: how to invoke, use the controls for, and read the printed 
listing from LOC86 

• Chapter 6, OH86: how to invoke OH86 

This manual also contains several appendixes, meant for quick access to the follow- 
ing information: 

• iAPX 86,88 absolute object file format definitions (Appendix A) 

• Hexadecimal-decimal conversion information (Appendix B) 

• The effect of available memory on the performance of LINK86, CREF86, 
LIB86, and LOC86 (Appendix C) 

• Summaries of iAPX 86,88 Family utility controls and error messages: 

• LINK86 (Appendix D) 

• CREF86 (Appendix E) 

• LIB86 (Appendix F) 

• LOC86 (Appendix G) 

• OH86 (Appendbc H) 
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NOTE 



The following appendixes address issues dependent on specific 
operating systems, such as operating environments, related 
publications, and examples. These appendixes contain foldout 
pages, designed to be opened out to your right and used in conjunc- 
tion with general instructions provided in the chapters and other 
appendixes. On these foldout pages you will find sample invoca- 
tions for the iAPX 86,88 Family utility controls and commands. 

• Additional information for Series III users (Appendix I) 

• Additional information for iRMX 86 users (Appendix J) 

• Additional information for Series IV users (Appendix K) 

Once you have gained sufficient familiarity with the basic principles of iAPX 86,88 
Family utilities operation, you will find the following publication convenient for 
quick syntax reference: 

• lAPX 86, 88 Family Utilities Pocket Reference, order number 1 2 1 669 

Before reading this manual, ensure that you are familiar with the following terms 
and conventions. 



Notational Conventions 

punctuation other than the following must be entered if required by the 

control syntax. 

{> indicates that one and only one of the syntactic items 

contained within the braces is required. 

[ ] indicates that the syntactic item or items contained within the 

brackets are optional. 

indicates that the preceding syntactic item may be repeated an 
indefinite number of times. (The ellipsis is often used within 
brackets and with a comma "[,...]" to indicate that preceding 
item may be repeated, but each repetition must be separated 
by a comma.) 

I separates various options within the brackets [ ] or braces 

UPPERCASE indicates that these characters must be entered exactly as 

shown. 

italic indicates a meta symbol that may be replaced with an item 

that fulfills the rules for that symbol. The actual symbol may 
be any of the following: 

pathname is a valid designation for a file; in its entirety, it consists of a 

directory-name and a filename . 

directory-name is that portion of a pattiname that acts as a file locator by 
identifying the device and/or directory containing the 
filename . 

filename is a valid name for the part of a pattiname that names a file. 
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mmimum-size 

maximum-size 

paragraph 

offset 

address 



are numbers and must follow Intel standards for number 
representation (see PL/M-86 or ASM86). Use the H suffix for 
hexadecimal, B suffix for binary, O or Q suffix for octal and 
D or nothing for decimal. 



segment name 
module name 
class name 
group name 
overlay name 
public symbol 
variable name 



are defined by the 8086 object file formats described in 
Appendix A. They may be up to forty characters 
long and may contain any of the following characters in any 
order: 

A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, 
W, X, Y. Z, 0, 1, 2, 3, 4, 5. 6, 7, 8, 9. ?, @, :. _, 



Black background is used in examples to indicate the user's 
entries. 



system-id 



pathnamel, 
pathname2, 

Vx.y 



is a generic label placed on sample listings where an operating 
system-dependent name would actually be printed. 

are generic labels placed on sample listings where one or more 
user-specified pathnames would actually be printed. 

is a generic label placed on sample listings where the version 
number of the product that produced the listing would 
actually be printed. 
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CHAPTER 1 
INTRODUCTION 



Program Development 



Program development is a process of varying complexity. The complexity depends 
on the language used to develop code, the complexity of the end product, and the 
tools chosen. 

Figure 1-1 shows the development process and the tools available for development 
of an iAPX86,88 Family-based product. 

The tools described in this manual are: 

• LINK86, which is a linkage and binding tool 

• CREF86, which provides a cross-reference of information on symbols in several 
modules 

• LIB86, which is the librarian function for 8086 object modules 

• LOC86, which is the relocation tool 

• OH86, which converts 8086 absolute object information to the hexadecimal 
format 
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Figure 1-1 . The iAPX86,88 Family Development Process 
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Introduction 



iAPX 86,88 FamUy UtUities 



Overview of the Utilities 

ASM86, ASM89, PL/M-86, PASCAL-86, FORTRAN-86, and other translators as 
well as LINK86 and LOC86 produce 8086 object modules. The language translators 
produce 8086 relocatable object modules that must usually be processed by utilities 
before execution. (Under certain circumstances the translators can produce absolute 
object modules, but this is rare and does not contribute to modular design.) LINK86 
combines 8086 object modules, and LOC86 converts relocatable object modules into 
absolute object modules. OH86 converts 8086 absolute object modules to 8086 hexa- 
decimal format. 

LINK86 combines a list of 8086 object modules into a single object module and 
attempts to match all external symbol declarations with their public symbol defini- 
tions in library modules. (LIB86 is the utility used to create and maintain program 
libraries.) The output of LINK86 is a relocatable object module. However, when 
specified in the controls, LINK86 produces a load-time-locatable (LTL) object 
module; an LTL module can be executed on an 8086-based system. (See the descrip- 
tion of LTL modules later in this chapter.) Whether the LINK86 output is an LTL or 
a relocatable object module, it can serve as input to LOC86. 

CREF86 provides a means for producing a cross-reference listing of public and 
external symbols in multiple 8086 object modules. The object modules may include 
library modules. The output produced by CREF86 should help the programmer to 
identify how symbols will be resolved by LINK86, given the same input files. 

LOC86 converts relocatable (or LTL) object modules to absolute object modules. 
Absolute object modules contain references that require the module segments to be 
placed at particular places in 8086 memory. 

The sequence in which the segments in the input niodules are combined and absolute 
addresses assigned to segments is determined by the controls supplied and the order 
in which the modules are listed in the LINK86 and LOC86 invocations. 



External References and Public Symbols 

An address field that refers to a location in a different object module is called an 
external reference. An external reference differs from a relative address because the 
translator that generates the modules knows nothing about the location of the 
referenced symbol. You must declare these references as external when coding a pro- 
gram. This tells the translator, and subsequently the relocation and linkage (R&L) 
utilities, that the target of the reference is in a different module. 

A module that contains external references is called an unsatisfied module. To 
satisfy the module, a module with a public symbol that matches the external symbol 
must be found. Associated with a public symbol in a module is an address that 
allows other modules, with the appropriate external reference, to reference the 
module with the public symbol. You must define these symbols as public when 
coding the program. This tells the source translator and the R&L utilities that other 
modules can reference the symbol. 

If there are external references that are not satisfied by public symbols, warning 
messages are issued and the resulting module remains unsatisfied. 
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Use of Libraries 

Libraries aid in the job of building programs. The library manager program, LIB86, 
creates and maintains files containing object modules. 

LINK86 and CREF86 treat library files in a special manner. If you specify a library 
file in the input to these utilities, they search the library for modules that satisfy 
unresolved external references in the input modules already read. This means that 
libraries should be specified after the input modules that contain external references. 
If a module included from the library has an external reference, the library is 
searched again to try to satisfy the reference. This process continues until all external 
references have been the subject of a search of all public symbols in the library 
modules. 



When L1NK86 and CREF86 search a library, they normally include only library 
modules that satisfy external references in the output. If no external references are 

satisfied by a library, no modules from the library are included in the LINK86 out- 
put module or the CREF86 output listing. However, L1NK86 and CREF86 provide 
the means to unconditionally include a library module even if there is no external 
reference to it. Figure 1-2 shows LINK86 handling of a library file. 
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Figure 1-2. Library Linkage by LINK86 
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Relative Addressing 

The relative addresses of instructions and data in program modules are assigned by 
the source translator. The addresses are relative to the beginning of the segment in 
which they reside. The relative address is actually the number of bytes from the 
beginning of the segment. 

After LINK86 combines all the input segments, LOC86 can be used to assign 
absolute memory addresses to all relative addresses. The resulting output module 
can only be executed when its segments are loaded at the absolute addresses assigned 
by the command. If LINK86 is used to create a bound object module, LOC86 is not 
needed to execute the program. 



The LINK86/LOC86 Process 

Although controls are not required for LINK86 and LOC86 execution, the com- 
mands invoking them may contain controls that affect their output. The controls 
make it possible to change the defaults for module combination, address assign- 
ment, and output information. 

The inputs are object modules in disk files. The input modules can contain relative 
addresses, absolute addresses, external references, and public symbols. The input 
modules must be in the 8086 object module format such as is generated by 8086 
translators and LINK86 and LOC86 themselves. 

LINK86 combines segments from the input modules, and for LTL object modules 
LINK86 orders segments in groups and assigns offsets. LOC86 orders the segments 
and assigns absolute addresses according to the controls specified with the command 
and/or the default algorithms. Both commands output the module when processing 
is completed along with any error messages and diagnostic information. Figure 1-3 
shows the LINK86/LOC86 process. 
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Figure 1-3. The LINK86/LOC86 Process 
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An 8086 Overview 

To use the R&L commands you must have an understanding of the following 
concepts: 

• Addresses, given as offsets into segments, which must be translated into 
absolute memory addresses, or base offsets 

• Segment definitions, which identify contiguous pieces of information, usually 
code or data 

• Class definitions, which identify segments that share common attributes and 
should be kept together 

• Group definitions, which identify segments that must be kept within a 64K byte 
range of memory 

• Overlay definitions, which identify modules that will be loaded in memory at 
different times during execution. 

• Load-time-locatable object modules 

Memory 

The 8086 can address up to a maximum of a megabyte of memory. In decimal a 
megabyte is 1,048,576 bytes. Memory addresses are always shown in hexadecimal. A 
megabyte of memory has the addresses: OH through OFFFFFH. 

Not all 8086-based systems will have a full megabyte of memory. Many systems will 
have gaps in the memory that is available. The different portions of memory will 
probably be implemented with different types of memory chips. The system monitor 
or supervisor is usually stored in ROM or PROM chips. Because it is not modified 
by execution it can be a permanent part of the system. This prevents the need to load 
it each time the system is turned on. The data that is referenced often is kept in high- 
speed RAM because it is modified frequently. It may be practical to keep data that is 
referenced less often in slower-speed memory. The size and composition of a 
system's memory is totally dependent on the application the system serves. 

Linkage and relocation is designed to handle the linking and locating of your pro- 
gram, no matter how your 8086-based system memory is implemented. It provides 
very flexible segment placement within any given memory configuration. 

8086 Addressing Techniques 

The 8086 addresses memory with a 20-bit address that is constructed from a segment 
address and a 16-bit offset from that segment address. This means that with a single 
segment address, 64K bytes of memory is directly addressable by changing only the 
offset. 

A hardware segment address is a 20-bit address. But the segment address is con- 
strained such that the segment is placed on a boundary that is a multiple of 16 (lOH). 
The segment address can be set to any hexadecimal address ending in 0: 

OH 
OlOH 
020H 

OFFFFOH 
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Because the low four bits of the 20-bit segment address are always zero, the segment 
address can be represented with only 16 bits. 

The segment address is kept in one of four 16-bit segment registers. Because there 
are four segment registers, the 8086 can, at any moment, access 256K (4 x 64K) bytes 
of memory. The full megabyte of memory is accessed by changing the values in the 
segment registers. Figure 1-4 shows the 8086 addressing concept. 
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Figure 1-4. 8086 Addressing 
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Segments 

Programs comprise pieces called segments, which are the fundamental units of 
linkage and relocation. The basic divisions have functional purposes related to the 
hardware configuration of memory. The portions of programs that are to be kept in 
ROM or PROM can be put in separate segments from the portions that will be kept 
in RAM. 



The 8086 Assembler allows the programmer to name the segments of the program 
being developed. The PL/M^6 compiler may generate predefined names for 
segments. 

A segment is a contiguous area of memory that is defined at translation time 
(assemble or compile). When defined, a segment does not necessarily have a fixed 
address or size. A fixed address is assigned to a segment during the locate function. 
The size can be changed by combining segments and by a control that specifies a 
specific size. Some translations may produce absolute object information, with 
absolute addresses and a specific segment size. 
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LINK86 combines all segments with the same complete (segment, class and overlay) 
name and combination type (memory, stack, etc.) from all input modules. The 
ordering of segments is done on the basis of these combined segments. The manner 
in which segments are combined depends on the alignment of the segments (which is 
described in the next topic) and a combining attribute associated with the segment. 

When we refer to combining segments, we are talking about how the segments will 
be loaded in memory, not how they will be stored in the output module. The 
segments in the LOC86 output module contain addresses^hat determine where they 
will be loaded in memory. The segments reside in the output module in the same 
order as they were in the input modules. Figure 1-5 shows the physical relationships 
between the input modules, output module, and loaded program. 
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Figure 1-5. Segment Physical Relationships 
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Segment Alignment 

A segment can have one (and in the case of the inpage attribute, two) of five align- 
ment attributes: 

• Byte, which means a segment can be located at any address 

• Word, which means a segment can be located only at an address that is a 
multiple of two, starting from address OH 

• Paragraph, which means a segment can be located only at an address that is a 
multiple of 16, starting from address 0 

• Page, which means a segment can be located only at an address that is a multiple 
of 256, starting from address 0 

• Inpage, which means a segment can be located at whichever of the preceding 
attributes apply, plus must be located so that it does not cross a page boundary 

Figure 1-6 shows the segment alignment boundaries. 

Any alignment attribute except byte can result in a gap between combined segments. 
For example, when two page-aligned segments are combined, there will always be a 
gap, unless the first happens to be an exact multiple of 256 bytes in length. 
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Figure 1-6. Segment Alignment Boundaries 
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Segment Combining 

Segments containing data and code are combined end to end. There may be a gap 
between the segments if the alignment characteristics require it. The relative 
addresses in the segments are adjusted for the new longer segment. 

There are two special cases of segment combination: stack segments and memory 
segments. Such translators as PL/M-86 define these segments with the names 
STACK and MEMORY. With ASM86 you must define them by adding the STACK 
or MEMORY parameter to the SEGMENT directive. 

When stack segments are combined, they are overlaid but their lengths are added 
together. 

When memory segments are combined, they are overlaid with their low addresses at 
a common address. The length of the combined memory segment is the length of the 
largest segment that was combined. No relative address adjusting is necessary. Nor- 
mally the memory segment is located above (at a higher memory address) the rest of 
the program segments if no controls are used to override this. 

To make sure that stack segments are combined correctly, you should always give 
them the same segment name in each module. The same is true of memory segments. 
If you are going to link assembly language routines to PL/M-86 routines you should 
give them the names STACK and MEMORY to be compatible with PL/M-86. 



Segment Locating 

Segments are located in the order in which they are encountered in the input 
modules. If classes (described in the next section) are defined, the segments from a 
class are located together. The locating algorithm can be changed by using LOC86 
locating controls. 
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One variation to the sequential locating of segments is how the MEMORY segment 
is located. When the first segment with the memory attribute is encountered, it is 
placed last in the list of segments. This means that after all other segments are 
located, the MEMORY segment will be assigned the highest address in the output 
module. 

NOTE 

The MEMORY segment may not get located at the top of the module if its 
name or class name appears in any LOC86 control (other than SEGSIZE) or 
it has the absolute attribute. 



Classes 

A class is a collection of segments. When segments are defined in assembly 
language, a class name can be specified. The segments generated by such translators 
as PL/M-86 are generated with predefined class names. Any number of segments 
can be given the same class name. Class names can extend beyond module bound- 
aries; the same class name can be used in different modules that are to be combined. 

The primary purpose of classes is to collect together (in an arbitrary order) segments 
that share a common attribute and to manipulate this collection at locate-time by 
specifying only the class name. 

All segments with the same class name are located together in the memory address 
space of the output module. (You can override class collection by specifying the 
location of segments with the LOC86 ORDER control or LOC86 ADDRESSES 
control.) 

Classes give you a second means of collecting like segments in the output module. 
The first is giving segments the same name. If you are developing several modules 
that are to be combined, you may want to give the segment containing executable 
code the name CODE in each module. If there are several differently named 
segments within a module that contain executable code, you may want to give these 
segments the class name of CODE that causes them to be located together but not 
combined. (The same name can be used for segments and classes.) 



Groups 

A group is also a collection of segments. Groups define addressing range limitations 
in 8086 object modules. A group specifies a collection of segments that must be 
located within a 64K byte range. This means that the entire group of segments can be 
addressed with offsets from a single segment register. Or, to put it another way, the 
segment register need not be changed when addressing any segment in a group. This 
permits efficient addressing within the module. 

Group addressing always begins at an address that is a multiple of 16 (i.e., a 
paragraph boundary). R&L does not manipulate segments of a group to make sure 
they fall within a 64K byte range. However, if they do not fit in the range, a warning 
message is issued. 

The segments included in a group do not have to be contiguous in the output 
module. The only requirement is that all the segments defined in the group must 
totally fall within 64K bytes of the beginning address of the group. 
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Overlays 

Sometimes your 8086 program is too large to fit into the memory available on the 
system. Overlays permit programs to be larger than the available memory. 

Typically, an overlay is composed of code and data that is executed in one phase of a 
program's execution, but not used at any other time. Once executed the memory 
used by this code can be overwritten with code and data used in an other phase. 
Sections of code that occupy the same part of memory at different times during 
execution are called overlays. 

Part of an overlaid program is always resident in memory; it usually comprises the 
main program module, frequently used routines, and the overlay loader. This part 
of the program is called the root. Figure 1-7 illustrates the memory configuration of 
one program that uses overlays. 
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Figure 1-7. Memory Configuration of Program with Overlays 639-7 



Position-Independent Code and Load-Time- 
Locatable Code 

An LTL (load-time-locatable) program can be loaded anywhere in memory (assum- 
ing alignment attributes are honored). Code and data addresses are assigned by the 
system loader. References to segment bases (segment registers) are permitted. The 
loader, when it determines where to locate each segment, must resolve these 
references to the segment bases. Before executing the LTL program, the loader must 
also initialize the segment registers. 

A PIC (position-independent-code) program is an LTL program, but it contains no 
references to segment bases.. To execute these programs the loader need only place 
the program in memory (recognizing alignment attributes) and initialize the segment 
registers and go. No fixup of segment bases is required. 
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CHAPTER 2 
LINK86 



LINK86 combines 8086 object modules and resolves references between 
independently translated modules. LINK86 takes a list of files and controls as input 
and produces two output files: a print file and an object file. 

Figure 2-1 illustrates the linkage process. The input files may be any object module 
(output from a translator, LINK86, LOC86 or an 8086 library file). The print file 
contains diagnostic information. The output object file is a bound load-time- 
locatable module or simply a relocatable module. 

This chapter provides details concerning the LINK86 invocation, controls, and print 
file. For definition of file-naming and syntax notation conventions used in this 
chapter, refer to Notational Conventions following the Preface. For a summary of 
the LINK86 controls and information on error and warning messages that may be 
produced, refer to Appendix D. For details concerning symbol table space limita- 
tions, refer to Appendix C. 
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Figure 2-1 . LINK86 Input and Output Files 
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LINK86 Invocation Line 

The general syntax for the invocation line is: 
[directory-name] L I N K 8 6 input iist[l 0 output fite] [controls] 

The input list is one or more modules to be linked together into a single object 
module: 

pathname[imodule name[, ...])][ f ...] 

Unless a module name is specified, all modules in a pathname are included. If the 
pathname is a library file, any modules named in parentheses are included in the out- 
put file even if they do not contain public symbol definitions for external symbols 
declared elsewhere in the input list. 
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The input list may also contain the control PUBLICSONLY before selected 
pathnames. If you wish to include a file called PO or PUBLICSONLY, ensure that 
the filename is preceded by a directory-name in order to distinguish it from the con- 
trol or its abbreviation. 

The order of modules in the input list affects the order of segments in the output file. 

TO output file designates the file to receive the linked object module. If output file is 
not specified, then output is directed to a file that has the same pathname as the first 
element in the input list, but its extension is .LNK. If the first element in the list is a 
PUBLICSONLY control, then the first pathname in its argument is used for the 
default name. 

If the 3IND control is specified, then the default name for the output file has no 
extension, and the object module can be executed without locating. 

The controls can be any subset of the controls specified in the next section. 

LINK86 Controls 

The controls are described in table 2-1 . 



Table 2-1 . Summary of LINK86 Controls 



Control 


Abbrev. 


Default 


ASSIGN( < variabfeiadd ress) > [, . . .]) 


AS 


Not applicable 


ASSUMEROOT(paf/)name) 


AR 


Not applicable 


BIND 


Bl 


NOBIND 


NOBINO 


NOBI 


COMMENTS 


CM 


COMMENTS 


NOCOMMENTS 


NOCM 


FASTLOAD 


FL 


NOFASTLOAD 


NOFASTLOAD 


NOFL 


INITCODE 


IC 


Not applicable 


LINES 


LI 


LINES 


NOLINES 


NOLI 


MAP 


MA 


MAP 


NOMAP 


NOMA 


MEMPOOL(m in-size[,max-size]) 


MP 


Not applicable 


UAMEimodule name) 


NA 


Not applicable 


0BJECTC0NTR0LS( 

{LINES 1 NOLINES | 
COMMENTS 1 NOCOMMENTS 1 
SYMBOLS 1 NOSYMBOLS | 
PUBLICS [EXCEPT(symZ?o/ [,...])] | 
NOPUBLICS [EXCEPT(sy/i7f)0/ [,...])] | 
TYPE 1 NOTYPE | 
PURGE 1 N0PURGE>[,...]) 


OC 


Not applicable 


Of\DEr\{{.group({segment[\class[\overfay]]y 

[,...])> 

[,-]) 


CD 


Not applicable 
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LINK86 



Table 2-1 . Summary of LINK86 Controls (Cont'd.) 



Control 


Abbrev. 


Default 


0\JERLkY[(overlay)] 


OV 


NOOVERLAY 


NOOVERLAY 


NOOV 


PRMT[ipathname)] 


PR 


PRINT(oi!/ecfff/e.MP1) 


NOPRINT 


NOPR 


PRINTCONTROLS( 

{LINES 1 NOLINES | 
COMMENTS 1 NOCOMMENTS | 
SYMBOLS 1 NOSYMBOLS | 
PUBLICS[EXCEPT(sy/nZ)o/[,...])] | 
NOPUBLICS [EKCEPKsymbol [,...])] | 
TYPE 1 NOTYPE | 
PURGE 1 NOPURGE>[,...]) 


PC 


Not applicable 


PUBLICS [EXCEPT(sym6o/ [,...])] 


PL (EC) 


PUBLICS 


NOPUBLICS [EXCEPT(sym6o/[,...])] 


NOPL[EC] 


PUBLICSONLY(pattna/ne[,...]) 


PO 


Not applicable 


PURGE 


PU 


NOPURGE 


NOPURGE 


NOPU 


RENAMEGROUPS({0ro(yp TO group > [,...]) 


RG 


Not applicable 


SEGSIZE{-Cseg/nef)f[ \class[\overlay]\ 
( min-size[,[nfiax-size]])y [,...]) 


SS 


Not applicable 


SYMBOLS 


SB 


SYMBOLS 


NOSYMBOLS 


NOSE 


SYMBOLCOLUMNSCCI | 2 1 3 1 4» 


SC 


SYMB0LC0LUMNS(2) 


TYPE 


TY 


TYPE 


NOTYPE 


NOTY 



If you specify a control more than once in a single invocation line, only the last ver- 
sion entered counts. For example, if you enter NOMAP on the invocation line and 
then later decide you want a link map, you can specify MAP. The ASSIGN control, 
however, is an exception to this general rule. 

The following controls are effective only when the BIND control is specified: 

FASTLOAD 
MEMPOOL 
ORDER 

PRINTCONTROLS 
SEGSIZE 

SYMBOLCOLUMNS 

The following control is effective only when the BIND control is NOT specified: 
INITCODE 

The following control is effective only when the OVERLAY control is specified: 
ASSUMEROOT 

At the end of this document you will find operating system-specific examples of the 
LINK86 controls. Fold out the pages containing the examples relevant to your 
operating environment and use them in conjunction with the syntax conventions 
provided in this chapter. 
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Syntax 

kSS I GHiivariable-name (address) >[,...]) 



Abbreviation 
AS 

Default 

Not applicable 

Definition 

ASSIGN makes it possible to define absolute addresses for symbols at LINK time. 
The absolute address associated with the variable-name is specified in address, 
which should be an absolute 20-bit memory address that conforms to PL/M-86 
notation. The variable-name is internally defined as a PUBLIC symbol. 



Notes 

• This control is particularly useful for memory-mapped I/O. 

• If the variable-name has a matching public definition in another module, the 
public definition in that module is flagged as as duplicate. Whenever a reference 
to the variable-name occurs, the variable defined in the ASSIGN control 
governs. 

• If multiple ASSIGN specifications are provided in one LINK86 invocation, aJI 
will be effective (not only the final entry). 
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ASSUMEROOT 



Syntax 

ASSUME ROOT (paf/ina/ne) 

Abbreviation 
AR 

Default 
Not applicable 

Definition 

ASSUMEROOT suppresses the inclusion of any library module(s) in an overlay if 
the library mod[ule(s) have already been included in a root file identified by 
pathname. When this control is used, the root file is scanned, and all external, 
undefined symbols in the overlay modules which have a matching definition in the 
root file are marked "temporarily resolved." This marking means that while a 
library search for the symbols will not be made, their status remains externally 
undefined until the overlays are linked with the root. 

Notes 

• This control should be used only in conjunction with the OVERLAY control 
and libraries- 

• This control will not eliminate common library modules from overlay to 
overlay. 

• This control may not be used when an input module already has an overlay 
record. 
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Syntax 

BIND 
NOBIND 



Abbreviation 
BI 

NOBI 



Default 
NOBIND 



Definition 

BIND combines the input modules into a load-time-locatable (LTL) module. An 
LTL module may be loaded and executed, and any logical reference to a segment or 
group base can be resolved at load time. The load-time-locatable output cannot be 
loaded by the ICE-86 loader or UPM. 

Notes 

• FASTLOAD, MEMPOOL, ORDER, SEGSIZE, and SYMBOLCOLUMNS 

have no effect when NOBIND is specified. 

• When NOBIND is in effect, [NOJLINES, [NOJSYMBOLS, [NOJPUBLICS, 
and [NO]PURGE affect only the output object module. 

• When BIND is specified, the default object file name has no extension. 
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COMMENTS/NOCOMMENTS 



Syntax 

COMMENTS 
NOCOMMENTS 



Abbreviation 
CM 

NOCM 



Default 
COMMENTS 



Definition 

COMMENTS allows object file comment records to remain in the output module. 
The NOCOMMENTS control removes all comment records except those designated 
as nonpurgable. 

Comment records are added to the object module for various reasons. All 
translators add a comment record, identifying the compiler or assembler that pro- 
duced it. 

Comment records are superfluous to the production of executable code and may be 
removed at any time during the development process. 

Notes 

• See PURGE, PRINTCONTROLS and OBJECTCONTROLS. 

• COMMENT records should not be removed when you submit an object file in a 
Software Problem Report. 

• NOCOMMENTS will decrease the size of the output object file. 
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Syntax 

FASTLOAD 
NOFASTLOAD 



Abbreviation 



FL 

NOFL 



Default 



NOFASTLOAD 



Definition 

FASTLOAD reduces program loading time by causing data record concatenation. 
The data records are concatenated to a maximum length of 64K. FASTLOAD also 
makes the object file compact by removing such information as local symbols, 
public records, comments, and type information (unless the object file contains 
unresolved external symbols). 



Notes 

• This control is effective only when BIND is specified. 

• Output produced with this control in effect may be incompatible with LINK86 
versions earlier than 2.0. 
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INITCODE 



Syntax 
INITCODE 



Abbreviation 
IC 



Default 

Not applicable 

Definition 

INITCODE causes LINK86 to create a new segment that contains code to initialize 
the segment registers. The equivalent assembly language code is shown below: 



STACKFRAME 


DW 


stack frame 


DATAFRAME 


DU 


data frame 


EXTRAFRAME 


DW 


extra frame 




CLI 






MOV 


SS, CS:STACKFRAME 




MOV 


SP, stack offset 




MOV 


DS, CS:DATAFRAME 




MOV 


ES, CS:EXTRAFRAME 




JMP 


program start 



Notes 

• The initialization code segment is created only if a register intialization record 
for 8086 segment registers exists in the input. These register initialization 
records are automatically produced by 8086-based translators for main 
modules. 

• BIND and OVERLAY controls used in conjunction with INITCODE will cause 
LINK86 to ignore the INITCODE control and issue a warning message. 

• INITCODE should be used to ensure compatibility with 8085-based LINK86, 
LOC86, and LIB86 products. 

• The name of the new segment, if created, is ??INITCODE. 
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Syntax 

LINES 
NOLINES 

Abbreviation 

LI 

NOLI 

Default 
LINES 

Definition 

LINES allows line number information to remain in the object file. ICE-86 and 
other debuggers use this information. The line number information is not needed to 
produce executable code. The NOLINES control removes this information from the 
output file. 

Notes 

• See PRINTCONTROLS and OBJECTCONTROLS. 

• See the PURGE control. 

• NOLINES will decrease the size of the output object file. 

• Unless BIND is in effect, LINES/NOLINES affects only the object module. 

• LINES has no effect on local symbols; the inclusion of local symbol records in 
the object file is controlled by SYMBOLS. 
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MAP/NOMAP 



Syntax 

MAP 
NOMAP 

Abbreviation 
MA 

NOMA 

Default 
MAP 

Definition 

MAP produces a link map and inserts it in the PRINT file. The link map contains 
information about the attributes of logical segments in the output module. This 
includes size, class, alignment attribute, address (if the segment is absolute) and 
overlay name (if the segment is a member of an overlay). 

NOMAP inhibits the production of the link map. 
Notes 

• MAP can be overridden by the NOPRINT control. 

• See the discussion of the link map at the end of this chapter. 
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Syntax 

M E M P 0 0 L ( minimum-size [ , maximum-size] ) 

Abbreviation 
MP 

Default 

Not applicable. 

Definition 

MEMPOOL specifies the dynamic memory requirements of the program. This 
allows the loader to check free memory at load time, and prevent a run-time error. 

The minimum size is a 20-bit number. There are three ways of specifying this value: 

• + indicates that the number should be added to the current dynamic memory 
requirements. 

• — indicates that the number should be subtracted from the current dynamic 
memory requirements. 

• no sign indicates that the number should become the new minimum dynamic 
memory requirement. 

The maximum size is a 20-bit number. There are two ways of specifying this value: 

• + indicates that the number should be added to the current minimum dynamic 
memory requirement. 

• no sign indicates that the number should become the new maximum dynamic 
memory requirement. 

Notes 

• The minimum-size must be less than or equal to the maximum-size. 

• MEMPOOL has no effect unless the BIND control is also specified. 
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NAME 



Syntax 

NAME {module name ) 



Abbreviation 
NA 

Default 

The module name of the first element in the input list. 
Definition 

NAME assigns the specified module name to the output module. If NAME is not 
specified, then the output module will have the name of the first module in the input 
list. 

The module name may be up to 40 characters long. It may be composed of any of 
the following characters in any order: 

? (question mark), 
@ (commercial at), 
: (colon), 
, (period), 

(underscore), 

A, B, C, Zor 
0,1, 2,..., 9. 

Lower-case letters may be used, but they are automatically converted to uppercase. 



Notes 

• NAME does not affect the output file's name. Only the module name in the 
output module's header record is changed. 
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Syntax 

OBJECTCONTROLS({LINES \ NOLINES | 

COMMENTS I NOCOMMENTS | 
SYMBOLS I NOSYMBOLS | 
PUBLICS [EXCEPT(sy/n;bo/[, ...])] | 
NOPUBLICS [EXCEPT (symi)o/[,. ..])]! 
TYPE I NOTYPE | 
PURGE I NOPURGE>[,...] 
) 



Abbreviation 
OC 



Default 

Controls apply to both the print file and the object file. 



Definition 

OBJECTCONTROLS causes the controls specified in its arguments to be applied to 
the object file only. Comment records, line number records, local and public symbol 
records, and symbol type records are selectively included or excluded from the 
object file. This will not affect the print file nor the information contained in it. 



Notes 

• Abbreviations for the controls within the parentheses may be given. 

• A control specified in both OBJECTCONTROLS and PRINTCONTROLS has 
the same effect as specifying it once outside of these controls. 
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ORDER 



Syntax 

0 R D E R ( {group name ( {segment name 

{\class name{\overlay name]]} 
[,..•])> 

I,...]) 

Abbreviation 
OD 

Default 

Segments are placed into object file in the same order in which they were 
encountered in the input list. 

Definition 

ORDER specifies a partial or complete order for the segments in one or more 
groups. 

The group name identifies the group whose segments are to be ordered. 

The segment name identifies the segments to be ordered. The \ class name and 
\overlay name may be used to resolve conflicts with duplicate segment names. If 
\overlay name is specified, the \class name is required. 

Notes 

• ORDER has no effect unless BIND is also specified. 

• If one of the segments specified is not contained in the designated group, an 
error message is generated. 

• See discussion of module combination at the end of the chapter for details of the 
default ordering. 
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Syntax 

0 V E R L A Y [ ( o i^er/ay name ) ] 
NOOVERLAY 



Abbreviation 
OV 

NOOV 



Default 
NOOVERLAY 



Definition 

OVERLAY specifies that all of the input modules shall be combined into a single 
overlay module. When the optional overlay name argument is specified, all 
segments contained within the overlay module have that name in addition to their 
segment names and class names. When overlay name is not specified, LINK86 uses 
the module name of the first module in the input list. 



Notes 

• Each overlay in a given program must be linked separately before they are all 
linked into a single object module. 

• The overlay specified in the argument must be the same as the overlay name 
used when calling the operating system to load the overlay. 

• When linking root and overlay files, LINK86 assumes the first file in the 
invocation line is the root. 

• The ASSUME ROOT control can be specified in conjunction with the 
OVERLAY control. 
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PRINT/NOPRINT 



Syntax 

PRlHl[ipathname)] 
NOPRINT 



Abbreviation 
PR 

NOPR 



Default 

P U HI (object f He. \^P^) 



Definition 

PRINT allows you to direct the link map and other diagnostic information to a 
particular file. If the PRINT control is not specified or if the control is given without 
an argument, the print file will have the same pathname as the output file except the 
extension will be .MPl . NOPRINT prevents the creation of this file. 



Notes 

• The discussion at the end of this chapter describes the contents of the print file. 

• MAP, SYMBOLCOLUMNS, LINES, SYMBOLS, PUBLICS and 
PRINTCONTROLS affect the contents of the print file. 
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Syntax 

PRINTCONTROLS({LINES | NOLINES | 

COMMENTS I NOCONNENTS | 
SYMBOLS I NOSYNBOLS | 
PUBLICS [EXCEPT (sym6o/[,...])] | 
NOPUBLICS [EXCEPT (sy/nibo/[,...])] I 
TYPE I NOTYPE | 
PURGE I NOPURGE}[,...] 
) 



Abbreviation 
PC 



Default 

Controls apply to both the print file and the object file. 



Definition 

PRINTCONTROLS causes the controls specified in its arguments to be applied to 
the print file only. Line number information, and local and public symbol informa- 
tion are selectively included or excluded from the print file. This will not affect the 
object file or the information contained in it. 



Notes 

• When a control is specified in both the PRINTCONTROLS and the 
OBJECTCONTROLS, it has the same effect as specifying it once outside of 
these controls. 

• Abbreviations to the parenthesized controls may be used. 

• Unless BIND is specified, PRINTCONTROLS and its arguments have no 
effect. 
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PUBLICS/NOPUBLICS 



Syntax 

PUBLICS [UZEPJ (public symbol [, ...])] 
N 0 P U B L I C S [ E X C E P T (pty^7//c symtoo/ [,...]) ] 

Abbreviation 

PL [EC] 
NOPL [EC] 

Default 
PUBLICS 



Definition 

PUBLICS causes the public symbol records to be kept in the object file and the 
corresponding information to be placed in the print file. Public symbol records are 
needed to resolve external symbol definitions in other files. The EXCEPT sub- 
control allows you to modify the control. Public records are used by LINK86 to 
resolve external references. 

Notes 

• The scope of PUBLICS can be modified by PRINTCONTROLS and 
OB JECTCONTROLS . 

• Unless BIND is specified PUBLICS/NOPUBLICS affect only the object file. 

• NOPUBLICS will decrease the size of the output object file. 
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Syntax 

PUBLICSONLY(paf/?name [,...]) 

Abbreviation 
PO 

Default 
Not applicable 

Definition 

PUBLICSONLY is an input list control. When used it must appear in the input list 
and not the control list, 

PUBLICSONLY indicates that only the absolute public symbol records of the argu- 
ment files will be used. The other records in the module will be ignored. This can be 
used to resolve external references to 8089 files and overlays when a multifile overlay 
system is desired. 

Notes 

• Although it is possible to create overlays using PUBLICSONLY, it is easier to 
use the OVERLAY control to create overlays. 
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PURGE/NOPURGE 



Syntax 

PURGE 
NOPURGE 



Abbreviation 
PU 

NOPU 



Default 
NOPURGE 



Definition 

PURGE in the control list is exactly the same as specifying NOLINES, 
NOSYMBOLS, NOCOMMENTS, NOPUBLICS, and NOTYPE. NOPURGE in 
the control list is the same as specifying LINES, SYMBOLS, COMMENTS, 
PUBLICS, and TYPE. 

PURGE removes all of the debug or public records from the object file and their 
information from the print file. It will produce the most compact object file 
possible. 

The records that would be included by NOPURGE are useful to debuggers, but 
otherwise they are unnecessary for producing executable code. 

Notes 

• PRINTCONTROLS and OBJECTCONTROLS can be used to modify the 
scope of PURGE. 

• Unless BIND is specified, PURGE affects only the output object file. 
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Syntax 

RENAMEGROUPS ({flfroap/7a/ne TO group name} [,...]) 

Abbreviation 
RG 

Default 

All groups keep the name they already have. 
Definition 

RENAMEGROUPS allows you to change the group names assigned by the 
translator. The first group name must be an existing group in one of the modules in 
the input list. 

Notes 

None 
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SEGSIZE 



Syntax 

S E G S I Z E ( {segment name[\class name[\overlay name]] 
{minimum size[ , [maximum size]] ) } 

[,...]) 

Abbreviation 
SS 

Default 

Not applicable 

Definition 

SEGSIZE allows you to specify the minimum memory space needed for any seg- 
ment. If you specify the maximum size for a segment, that segment must either not 
be a member of any group or be the last segment in the group. 

The segment name identifies the segment whose size is to be changed. 

The minimum size is a 16-bit number. There are three ways of specifying this value: 

• + indicates that the number should be added to the current segment length. 

• — indicates that the number should be subtracted from the current segment 
length. 

• no sign indicates that the number should become the new segment length. 

The maximum size is a 16-bit number. There are two ways of specifying this value: 

• + indicates that the number should be added to the minimum segment length. 

• no sign indicates that the number should become the new maximum segment 
length. 

Notes 

• The maximum segment size must always be greater than or equal to the 
minimum segment size. 

• Segment lengths are initially assigned by the translator. 

• Unless BIND is also specified SEGSIZE has no effect. 
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Syntax 

SYMBOLS 
NOSYMBOLS 

Abbreviation 
SB 

NOSB 

Default 
SYMBOLS 

Definition 

SYMBOLS specifies that all local symbol records shall be included in the object file. 
Local symbol records are used by debuggers. 

Notes 

• Unless BIND is also specified, SYMBOLS affects only the output object file. 

• NOSYMBOLS will decrease the size of the output object file. 

• SYMBOLS has no effect on line numbers; the inclusion of line numbers in the 
object file is controlled by the LINES control. 
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SYMBOLCOLUMNS 



Syntax 

SYMB0LC0LUMNS({1 | 2 | 3 | 4}) 

Abbreviation 
SC 

Default 

SYMB0LC0LUMNS(2) 
Definition 

SYMBOLCOLUMNS indicates the number of columns to be used when producing 
the symbol table for the object module. Two columns fit on a 78-character line; four 
columns fit on a single 128-character line printer line. 

Notes 

• SYMBOLCOLUMNS has no effect unless BIND is also specified. 
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Syntax 

TYPE 
NOTYPE 



Abbreviation 
TY 

NOTY 

Default 

TYPE 

Definition 

TYPE specifies that type checking is to be performed on the object file. Symbol type 
records produced by the translator are used by LINK86 to perform type checking on 
modules. Symbol type records should be kept in the file if it may be relinked with 
another file. 



Notes 

• NOTYPE will decrease the size of the ouput object file without affecting 
run-time operation. 
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LINK86's Print File 

The print file is always created unless you specify NOPRINT. The optional argu- 
ment to PRINT designates the name of the print file. The default print file is the 
object file with the extension .MPl . 

The print file may contain as many as five parts: 

1 . A header (always in the print file) 

2. A link map (requires MAP) 

3 . A group map (requires BIND) 

4. A symbol table (requires BIND and PUBLICS, LINES, or SYMBOLS) 

5 . An error message list (always included when they occur) 

The Header 

The header is self-explanatory; it identifies the 8086 linker by version number and 
gives the important details about the input and output files used during this execu- 
tion. Figure 2-2 shows an example of LINK86's print file header. 



system-Id 8086 LINKER, Vx.y 

INPUT FI LES : : pathname1.pathname2 
OUTPUT FILE: I pathname 

CONTBOLS SPBCIFIBO IN INVOCATION COMMAND: 
BIND 

DATE: UUIIDD/rr TIME: HHMM.SS 




Figure 2-2. LINK86 Print File Header 



The Link Map 

The link map supplies useful information about segments in the object file — order, 
size, alignment attribute, and segment, class, and overlay names. Figure 2-3 shows 
LINK86*s link map. 




LOGICAL SEGMENTS INCLUDED: 

LENGTH ADDBESS ALIGN SEGMENT CLASS OVEBLAX 



09fi6H b CODE CODE 

0016B b CONST CONST 

0B38H — N DATA DATA 

0**2H h STACK STACK 

OOOOfa b MEMOBl MEHORX 

OOOOH G ?78EG 



INPUT MOODLBS INCLUDED: 
paUmameKnOOT) 




Figure 2-3. LINK86 Link Map 
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The map consists of three parts: 

• Segment map 

• Input module list 

• Unresolved symbol list 

The segment map describes all of the segments included in the object file. Each seg- 
ment description includes five entries: length, the address (if the segment is 
absolute), alignment attribute, segment name, class name and overlay name, if any. 

A segment may have any one of the following alignment attributes: 

A absolute 

B byte 

G paragraph 

M member of an LTL group 
P page 
U word 
R in-page 

In-page alignment means that the entire segment must be resident within a single 
256-byte page. The address of the first byte in any page has zeros in the first 2- 
hexadecimal digits (OOH, lOOH, 200H,...0FFF00H). 

The module list identifies the order of modules included in the output file. LINK86 
gives both the file containing the module and the module name for each entry in the 
list. 

The unresolved symbol list itemizes each external symbol whose public definition 
was not encountered. The module that references the unresolved symbol is also 
indicated. The printed message that appears under the heading UNRESOLVED 
EXTERNAL NAMES is as follows: 

• symbol name IN pathname (module name) 

• If ASSUMEROOT is specified, the message would read: 
symbolname (DEFINED IN ROOT- f HE .pathname) 

• If PUBLICS/NOPUBLICS EXCEPT is specified, the message would read: 
symbolnamelH LINK86 COMMAND LINE 

The Group Map 

LINK86 produces a group map when the BIND control is specified. Each group 
name and all segments contained in that group are listed. The offset from the group 
base for each segment appears to the right of the segment name. Figure 2-4 shows an 
example of the group map. 



GROUP NAHE: CQROUP 

OFFSET SEGMENT NAHE 
OOOOH CODE 

GROUP NAME: DGROUP 

OFFSET SEGMENT NAME 
OOOOH CONST 
0016H DATA 
0B4BB STACK 
0F90H MEMORI 





Figure 2-4. LINK86 Group Map 
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The Symbol Table 

LINK86 produces a symbol table only when the following conditions are true: 

1 . BIND is specified 

2. PRINT and MAP controls are in effect. 

3. At least one of the following controls is in effect: PUBLICS, LINES, or 
SYMBOLS. 

Figure 2-5 shows LINK86's symbol table with the SYMBOLCOLUMNS set at two 
(the default). The symbol table is shown in two parts: the top section contains the 
public symbol information; the lower section contains line and local symbol 
information. 




SXMBOL TABLE OF MODULE ROOT 



BASE 


OFFSET 


T»E 


SXMBOL 


BASE 


OFFSET 


TYPE 


SXMBOL 


G(2) 


0166H 


PUB 


BIKDCOMTaOL 


0(2} 


004CB 


PUB 


BNOOEBASE 


G(2) 


0018H 


PUB 


BUFBASE 


G(2) 


0016H 


PUB 


BUFLEH 


G(2) 


OOilEil 


PUB 


CLASHHODEBASE 


G(2} 


0060B 


PUB 


COCONM 


.0(2) 


01 SAB 


PUB 


COMMEMTSCOMIROL 


G(2) 


0171H 


PUB 


CURRENTOVEBLAXNU 


G(2) 


0173H 


PUB 


OBBU6T0GGLE 


G(2) 


00A7H 


PUB 


-M 

DEFAULIPRTFILENA 


G(2) 


0062U 


PUB 


EXCEPTIOH 


G(2) 


00488 


PUB 


-ME 
FANODEBASE 


6(2) 


006EB 


PUB 


FBLOCKBASB 


G(2) 


006AB 


PUB 


FBLOCKLISTHEAD 


C(2) 


006Cfl 


PUB 


FBLOCKLISTTAIL 


G(2) 


013DH 


PUB 


FBLOCKSEQUENCENU 
















-MBEB 


G(2) 


004AB 


PUB 


FBHODEBASE 


G(2) 


0046H 


PUB 


FDNODEBASE 


G(2) 


OOtfl 


PUB 


FEMOOEBASB 


G(2) 


0040B 


PUB 


FFHODEBASE 


G(2) 


0034H 


PUB 


FIBSTBHODEP 


G(2) 


0028H 


PUB 


FI8STEXH0DEP 


G(2) 


002CH 


PUB 


FIBSTGRNODBP 


G(2) 


001CH 


PUB 


FIRSTNMNOOEP 


G(2) 


0030B 


PUB 


FIRSTOTHODEP 


G(2) 


0050H 


PUB 


FIRSTREHAMEBLOCE 


G(2) 


0020H 


PUB 


FIRSTSGNOOEP 


G(2) 


0024B 


PUB 


-P 

FIRSTTDNODEP 


G(2) 


0038H 


PDB 


GKMODEBASE 


G(2) 


0B4CB 


PDB 


BIGHESTOATALOCAT 



-lOH 




NODULE NAME s ROOT 



BASE 


OFFSET 


TXFE 


SXMBOL 


BASE 


OFFSET 


TYPE 


SXMBOL 


G(2) 


0F90H 


SYH 


HEMORX 


6(2) 


. OOOOB 


SIM 


COPXRIGHT 


G(2) 


0016b 


SXM 


BUFLEM 


G(2) 


001 6B 


SXM 


BUFBASE 


6(1) 


00F7H 


SIM 


ERROR 


G(1) 


OOFEB 


SXM 


HARHIHG 


6(2) 


001AH 


SXM 


LASTHMIiaOEP 


6(2) 


001CB 


SXM 


FIRSTNMMOOEP 


G(2) 


001EB 


SXM 


LASTSGMODEP 


6(2) 


0020B 


SXM 


FIRSTS6H0DEP 


6(2) 


0022B 


SXM 


LASTTOMOOBP 


6(2} 


0024H 


SXM 


FIRSTTDNODEP 


6(2) 


0026B 


SXM 


LASTEZBOOEP 


6(2) 


0028B 


SXM 


FIRSTEXNOOEP 


6(2) 


002AB 


SXM 


LAST6RB0DEP 


6(2) 


002CB 


SXM 


FIRSTGRNODEP 


G(2) 


002Eh 


SXM 


LASTOVaODEP 


6(2) 


0030U 


SXM 


FIRSTOVNODEP 


6(2) 


0032H 


SXM 


LASTBBODEP 


6(2) 


0034B 


SXM 


FIRSTBNODEP 


6(2) 


0036b 


SXM 


SGMOOEBASE 


6(2) 


0038B 


SXM 


6RN0DEBASE 


6(2) 


003AB 


SXM 


SXaODEBASE 


0(2) 


003 CH 


SXM 


NHNODEBASE 


6(2) 


003EH 


SXM 


TOMODEBASE 


G(2) 


0040H 


SXM 


FFHODEBASE 


6(2) 


0042H 


SXM 


OVMODEBASE 


6(2} 


0044B 


SXM 


FENOOEBASE 


6(2) 


0046H 


SXM 


FOMOOEBASE 


6(2} 


0048H 


SXM 


FANODEBASE 


6(2) 


004AH 


SXM 


FBHODEBASE 


6(2) 


004CB 


SXM 


BNODEBASE 


6(2) 


004EH 


SXM 


CLASBHOOBBASE 


G(2) 


0050B 


SXM 


FIRSTRENAMEBLOCK 



-p 




Figure 2-5. LINK86 Symbol Table 
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G(2) 


01A4H 


SYM 


SIGNONHSG 


G(1) 


0174H 


SYM 


PRINTNAHE 


G(1) 


01A3H 


SYM 


INITIALIZtlNPUT 


G(1) 


01 A8h 


SYM 


OPENFBLOCKFILE 


G(1) 


01F6H 


SYM 


CLOSEFBLOCKFILE 


G(1) 


00F7H 


LIN 


7 


G(1) 


OOFAH 


LIN 


10 


G(1) 


OOFEH 


LIN 


11 


G(1 ) 


0101H 


LIN 


14 


G(1) 


0105H 


LIN 


73 


G(1) 


0100H 


LIN 


75 


G(1) 


OlOfH 


LIN 


76 


G(1) 


01 IbH 


LIN 


77 


G(1) 


01 10H 


LIN 


78 


G(1 ) 


0126H 


LIN 


79 


G(1) 


012AH 


LIN 


80 


G(1 ) 


012DH 


LIN 


84 


G(1) 


0136H 


LIN 


85 


G(1 ) 


01 3DH 


LIN 


86 


G(1) 


014'4H 


LIN 


87 


G(1 ) 


01 51H 


LIN 


88 


G(1) 


015AH 


LIN 


89 


G(1 ) 


0168H 


LIN 


90 


G(1) 


0170H 


LIN 


91 


G(1 ) 


017tH 


LIN 


94 


G(1) 


0177H 


LIN 


96 


G(1) 


018EH 


LIN 


97 


0(1) 


0198H 


LIN 


98 


G(1) 


019FH 


LIN 


99 


G( 1 ) 


01A3H 


LIN 


100 


G(1 ) 


01A6H 


LIN 


103 


G(1) 


01A8H 


LIN 


105 


G(1) 


01ABH 


LIN 


106 


G(1) 


01BEH 


LIN 


107 


G(1) 


01C8H 


LIN 


108 


G(1) 


01CFH 


LIN 


109 




REFERENCES TO SEGMENT BASES EXIST IN INPUT MODULES: 
ROOT 



Figure 2-5. LINK86 Symbol Table (Cont'd.) 



BASE is usually a symbolic group or segment index. If the base is the stack, then 
STACK is used instead of the index. 

OFFSET is a four-digit hexadecimal number that is the offset of the symbol or line 
from BASE, or from the current BP for stack symbols. 

TYPE describes the kind of symbol it is. There are four possible entries in the TYPE 
column: 

B A S based on an other symbol's value 
LIN line (not a symbol) 

PUB public symbol (alphabetized within each separate BASE) 
SYM local symbol 

SYMBOL refers to the name of the symbol or number of the line. If the 
SYMBOLCOLUMNS value is one, this field is 40 characters wide. Otherwise, this 
field is 16 characters wide. If the symbol name is longer than the width of the field, 
then the name is hyphenated and continued on the next line. 

If there are any references to segment bases in the input modules (if the output 
module is an LTL program), LINK86 prints the following message at the bottom of 
figure 2-5. The message identifies all input modules containing such references. 
These references are to be resolved by the system loader or LOC86. 

Error Messages 

The warning messages are listed consecutively as warning situations are 
encountered. They may appear before or after the link map. Errors always terminate 
processing — an error message will always be the last line in the print file. 

See the discussion of the interpretation of individual messages in Appendix C. 
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CREF86 scans 8086 object modules to provide a cross-reference among external and 
public symbols in multiple modules, CREF86 accepts a list of files and controls as 
input and produces one output file: a print file. 

Figure 3-1 illustrates the types of input accepted and output produced. The input 
modules may include one or more of the following 8086 object modules: 

• Unlinked modules from one or more translators 

• Library files or specific library modules 

• Linked modules 

The output file consists of information about files and modules, plus an 
alphabetically sorted list of external and public symbols. Information printed for 
each symbol includes the name of the module defining the symbol and the name(s) 
of the module(s) declaring the symbol as external. 

This chapter provides details concerning the CREF86 invocation, controls, and 
cross-reference listing. For definition of file-naming and syntax notation conven- 
tions used in this chapter, refer to Notational Conventions following the Preface. 
For a summary of the CREF86 controls and information on error and warning 
messages which may be produced, refer to Appendix E. For details concerning 
CREF86 symbol table space limitations, refer to Appendix C. 



TRANSLATED 
OBJECT 
MODULE(S) 



LIBRARY 
MODULE(S) 



INVOCATION 
LINE CONTROLS 

J..., 



•i CREF86 !- 



LINKED 
OBJECT 
MODULE(S) 



I 



PRINT FILE 
"CRF" 



CONSOLE 
MESSAGES 



Figure 3-1 . CREF86 Input and Output Files 
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CREF86 Invocation Line 



The general syntax for invocation is: 
[directory-name] C R E F 8 6 input list[controls] 

The input list is one or more modules to be scanned for external-public cross- 
references: 

pattiname[ {module name[ ,...])][,...] 

Unless a module name is specified, all modules in a pathname are included in the 
cross-reference listing produced. If the pathname is a library file, any modules 
named in parentheses are included in the cross-reference listing, even if they do not 
contain public symbol definitions for external symbols declared elsewhere in the 
input list. 

Either all or none of the pathnames may contain overlay records (produced by 
LINK86 with the OVERLAY control). If the input modules do contain overlay 
records, the first file named in the invocation is considered to be the root file; the 
rest are treated as overlays. 

The controls can be any subset of the controls described in the next section. 



CREF86 Controls 



The controls specify cross-reference listing attributes such as print file name, the 
title at the top of each listing page, and the amount of information printed on each 
page. The controls are described in table 3-1 . 



Table 3-1 . Summary of CREF86 Controls 



Control 


Abbrev. 


Default 


PAGELENGTH(n(//n6er) 


PL 


PAGELENGTH(60) 


PAGEWIDTH(/it//n/>e/') 


PW 


PAGEWIDTH(120) 


Pm\l{{pathname)\ 


PR 


PRINT(//rsf input ///e.CRF) 


JUXJEipharacter-string) 


TT 


Not applicable 



If there are multiple occurrences of any control in the invocation line, the rightmost 
occurrence governs. 

At the end of this document you will find operating system-specific examples of the 
CREF86 controls. Fold out the pages containing the examples relevant to your 
operating environment and use them in conjunction with the syntax conventions 
provided in this chapter. 
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PAGELENGTH 



Syntax 

PAGELENGTH (/7//miE}er) 

Abbreviation 
PL 

Default 

PAGELENGTH(60) 
Definition 

PAGELENGTH specifies the number of lines to be printed on each page. The 
number must be a decimal value between 10 and 255, inclusive. 

Notes 

None 
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Syntax 

PAGEWIDTH (na/n^er) 

Abbreviation 
PW 

Default 

PAGEUIDTH(120) 
Definition 

PAGEWIDTH specifies the maximum number of characters to be printed on a 
single line. The number must be a decimal value from 80 to 132, inclusive. 

Notes 

• PAGEWIDTH truncates the TITLE if TITLE is greater than the number of 
unused character locations on the title line. 

• If the specified PAGEWIDTH does not allow enough space to print the 
referring module name(s) on the same line as the defining module name, the 
referring module names(s) will be printed on separate lines. 



3-4 



iAPX 86,88 Family Utilities 



PRINT 



Syntax 

PRlHl[ipathname)] 

Abbreviation 
PR 

Default 

P R I M T ( first input file . C R F ) 
Definition 

PRINT provides the ability to specify a pathname for the cross-reference Usting. 
The pathname identifies the destination of the listing. If the PRINT control is not 
specified or if the control is given without an argument, the print file will have the 
same pathname as the first file in the input list, except the extension will be .CRF. 

Notes 

• If no PRINT control is specified, output goes to a default file. The name of the 
default file is the name of the first file in the invocation command with the 
extension .CRF. 

• If PRINT is specified with no pathname, output goes to the default file. 
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Syntax 

TITLE (.character string) 

Abbreviation 
TT 

Default 
Not applicable 

Definition 

TITLE may be used to specify a heading having a character string of null to 80 
characters, inclusive. This heading appears on the first line of every page of the 
cross-reference listing. 

Notes 

• The TITLE string is truncated if the PAGEWIDTH control is not large enough 
to accommodate the entire string. 

• If the character string contains any characters defined by the operating system 
as special, the string must be delimited in accord with operating system conven- 
tions for special characters and string delimiters. 
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CREF86's Print File 

The print file is a cross-reference listing of external and public symbols in the input 
modules. This listing consists of the following parts: 

• A header 

• Warnings (if any) 

• Module list 

• Cross-reference information 



Header 

Figure 3-2 illustrates the components printed in this part of the cross-reference 
listing: 

• A title line output by CREF86, usually consisting of a program identifier 
(CREF86), any user-defined TITLE, date of listing, and the page number 

• A line identifying the CREF86 environment (operating system and version 
number) 

• One or more lines summarizing the pathnames of input files 

• A line for identifying the print file pathname 

• One or more lines giving the controls specified at invocation, present only if 
controls were specified 



Warnings 

Figure 3-3 illustrates how warning messages appear on the cross-reference listing 
when CREF86 detects such conditions as mismatched types, modules not found, etc. 
Refer to Appendix E for information on CREF86 error and warning messages. 



BXAhPLb OF CHOSS REFEHEMCE USIkG CRBFb6 



syslem-U CREF&b Vx.y 
IMFUT FILES: 



ODTPDT FILE: 
CONTROLS SPECIFIED: 



pathnunel pathname! pathnames pathname^ pathnames 

pathname? pathnames pathnames pathnamelo pathnamell 

pathnamelS pathnameU pathnamelS pathnameie palhname17 
plhaametS 

PR(OUT) TTCBXAHPLB OP CROSS REFERBHCE USIMG CREF86) Pii(120) PL(60) 



pathnames 
palhnamet2 



Figure 3-2. Header of Cross-Reference Listing 




kARMlNG 19: TXPE MISMATCH 
FILE: pathnamelS 
MODULE: HISHAICU 
SYMBOL : EHAMEID 



NARHIIIG 19: TYPE MISMATCh 

FILE: palhnameK 

MODULE: MISMATCH 

SYMBOL: FOUR 
VARMIHG 20: SPECIFIED MODULE HOT POUHD 

FILE: pathnameie 

MODULE: UHKNOHi|_MODaLE 




Figure 3-3. Warning Messages on CREF86 Listing 
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Module List 

The module list, shown in figure 3-4, is a tabulated summary of all input files and 
corresponding modules included from these files. 

After the module list is printed, the rest of the page is skipped, so that the symbol 
cross-references begin on the next new page. 



MODULES INCLUDED: 

FILE NAME 

pathnamel 

pathnameZ 

pathnames 

pathnameA 

paUmameS 

pathnames 

pathname? 

pathnames 

pathnames 

pathnamelO 

pathnamell 

pathnanie12 

pathnamelS 

pathname14 

pathnamelS 

pathnameie 

pathnamel/ 



NODULE NiME(S) 

CRGF66 

PARSE 

SIGNON 

NEXTSTATE 

ERROR 

UTILITIES 

HEMORXHAN A6EHEN T 

SCANMODULES 

PROCESSSECOROS 

SCANUIILITIES 

LISIOUTPUT 

LISTUTILITIES 

SIMBOLSORT 

OBJMAM 

MISMATCH 

DQALLOCATE 
DQDETACH 
DQGETTIME 
SISTEMSTACK 



DQATTACH 

DQEXIT 

DQOFEN 



DQCHAMGEEXTEMSIOR 

OQFREE 

DQBEAO 



DQCREATE 

DQGETARGOMENT 

OQSEEK 



DQOECOOEBXCEPTIOH 

DQGETSXSTEHID 

DQIiRITE 



Figure 3-4. Module List on CREF86 Listing 



Symbol Cross-Reference Information 

Figure 3-5 illustrates the format for listing data for all external and public symbols 
referenced in the Module List. 

The first column contains the names of the external and public symbols, in 
alphabetical order. 

The second column identifies the type of each symbol, as declared in the external or 
public reference. The following tabulation identifies the entries which may occur in 
this column: 

CREF86 Entry Symbol Type 

BYTE 8-blt unsigned 

WORD 16-bit unsigned 

DWORD 32-blt unsigned 

LWORD 64-blt unsigned 

INTEGER(n) n = 1,2.4,or8bytes 

REAL(n) n = 1,2,4,or8bytes 

POINTER 
STRUCTURE 
ARRAY OF 

UNKNOWN null 

FILE 

LABEL 

PROCEDURE 

(NEAR, FAR) 
CONSTANT 
SELECTOR 

The symbol type that appears in the second column is that associated with the first 
occurrence of that symbol in the input list. 
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C8EP86 KXANPLE OF CROSS 


RBFEHEHCE USING 


CREF86 




MU/DD/YY PAGE 


3 


SXMBOL HAMS 


SIHBOL TIFS 




DEFINING MODULE; RBFERRIHG HODULE(S) 






UNKMOHII 






OBJ MAN 








UNKNOHN 






OBJMAH 








PROCEDURE 


NEAR 




UTILITIES 








PROCEDURE 
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Figure 3-5. Symbol Cross-Reference Information 



The third column contains the following for each symbols listed: 

• The name of the module in which the symbol is defined public (defining 
module) 

• A semicolon (;), if there are external references to the symbol in any of the input 

modules 

• The name(s) of the modules(s) in which the symbol is declared external 
(referring module(s)) 

The third column is also used to flag unresolved and duplicate references. In the case 
of unresolved external references, the string ***UNRESOLVED*** appears before 
the semicolon. In the case of duplicate references, i.e., when a symbol has two or 
more public definitions, the first public declaration is considered legal, and the rest 
are flagged as duplicates. The string ***DUPLICATE DECLARATION*** 
appears, followed by a colon (:) and the name of the module containing the 
duplicate public declaration. 

If the input files contain overlays, CREF86 produces a symbol cross-reference that 
consolidates all the symbols from all overlay and root modules. The first file in the 
input list is considered to be the root file. CREF86 distinguishes between public 
symbols with the same name in different overlays and does not flag these symbols as 
duplicates. However, CREF86 does flag duplicate public declarations within any 
one root/overlay combination. 
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CHAPTER 4 
LIB86 



LIB86 allows you to create, modify, and examine library files. It is an interactive 
program. 

This chapter provides details concerning LIB86 invocation and commands. For 
definition of file-naming and syntax notation conventions used in this chapter, refer 
to Notational Conventions following the Preface. For a summary of the LIB86 com- 
mands and information on error and warning messages that may be produced, refer 
to Appendix F. For details concerning LIB86 symbol table space limitations, refer to 
Appendix C. 



LIB86 Invocation 



The general syntax for the invocation line is: 
[directory-name] L I b%6[comment] 



LIB86 Commands 



Once LIB86 has begun execution, it displays an asterisk (*) and waits for a com- 
mand. Table 4-1 lists all of LIB86's commands. 



Table 4-1 . Summary of LIB86 Commands 



Command 


Abbrev. 


Description 


ADD ipathname[(module name [,...])]'> 
[,...] TO pathname 


A 


Adds modules to a library 


CREATE pattmame 


C 


Creates library files 


DELETE patt)name{moclu/e name [,...]) 


D 


Deletes modules from a library file 


EXIT 


E 


Terminates session with LIB86 


LIST ipattiname[{module name [,...])]> 
[,...] [TO pathname] [PUBLICS] 


L 

[P] 


Lists modules contained in a library 
file, and optionally lists all publics 



At the end of this document you will find operating system-specific examples of the 
LIB86 commands. Fold out the pages containing the examples relevant to your 
operating environment and use them in conjunction with the syntax conventions 
provided in this chapter. 



4-1 



ADD 



iAPX 86,88 Family Utilitieis 



Syntax 

ADD ipathname1[imodule name[, ...])]}[, ...]10 pathname2 



Abbreviation 
A 



Definition 

ADD adds modules to a library file. 

The pathnamel can be an object file or a library file. 

The pathname2 is the destination library file. The library must exist before the ADD 
command is given; it may contain other modules. 

If pathnamel is an object file produced by a translator, LINK86, or LOC86, then all 
modules contained within the object file will be added to the designated library. 

If pathname2 is a library file, it may be specified with or without the module name 
list. If no module name list is specified, all modules contained in the source library 
will be added to the destination library. If the module name list is specified, then 
only the modules specified within the parentheses are added to the destination 
Ubrary. 
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CREATE 



Syntax 

CREATE pathname 

Abbreviation 
C 

Definition 

CREATE creates a library file with the specified pathname. 
Notes 

• If a file with the specified pathname already exists, the library will not be 
created and an error message will be provided. 
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DELETE 
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Syntax 

DELETE pathname (module name [,...]) 

Abbreviation 
D 

Definition 

DELETE removes modules from a library file. Modules can be deleted from only 
one library at a time. 

Notes 

None 
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EXIT 



Syntax 
EXIT 

Abbreviation 
E 

Definition 

EXIT terminates a session with LIB86 and returns control to the operating system. 
Notes 

• LIB86 disassembles libraries into an internal form. The library is not 
reconstituted until the EXIT command is processed. Therefore significant I/O 
will take place following an EXIT command. 
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Syntax 

LIST {pathname1[imodule name [, ...])]} [,...][T0 pathname2] 
[PUBLICS] 

Abbreviation 
L [P] 

Definition 

LIST prints the names of modules, and optionally the public symbols contained in 
those modules, to the specified output pathname. 

The pathnamel is the library whose modules are to be listed. 

The module name, if specified, identifies the modules to be listed. 

TO pathname2 identifies the device or file to receive the listing. If it is not specified, 
the listing is directed to the console output device. 

PUBLICS indicates that, in addition to the module names, all public symbols con- 
tained within the module will also be listed. PUBLICS may be abbreviated as 'P'. 

Notes 
None 
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CHAPTER 5 
LOC86 



LOC86 changes a relocatable 8086 object module into an absolute object module. 
As figure 5-1 illustrates, LOC86 takes a single 8086 object module as input and out- 
puts a located object file and, optionally, a print file. The print file output contains 
diagnostic information. The object file contains absolute object code. 

This chapter provides details concerning the LOC86 invocation, controls, and print 
file. For definition of file-naming and syntax notation conventions used in this 
chapter, refer to Notational Conventions following the Preface. For a summary of 
the LOC86 controls and information on error and warning messages that may be 
produced, refer to Appendbc G. For details concerning LOC86 segment support 
capabilities, refer to Appendix C. 



INVOCATION 
LINE CONTROLS 




ABSOLUTE 
OBJECT 
MODULE 



CONSOLE 
MESSAGES 



PRINT 
FILE 
••.MP2" 



Figure 5-1 . LOC86 Input and Output Files 
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LOC86 Invocation Line 

the general syntax for the invocation line is: 
[directory-name] L 0 C 8 6 input file [T 0 object file] [controls] 

The input file is a file containing an object module to be located. It is usually, but 
not necessarily, the output from LINK86. 

TO object file specifies the file to receive the located object module. In most cases 
this is an executable file. If object file is not specified, then output will be directed to 
a file that has the same pathname as the input file^ except it will have no extension. 



The controls may be any subset of the controls described in the next section. 



LOC86 Controls 

The controls are described in table 5-1 . 

If you specify the same control more than once in the same invocation line, only the 
last version entered counts. For example, if you enter NOMAP, and then later 
decide you want a locate map, you can enter the MAP control without error. The 
second version of the control is recognized and the first is ignored. 

At the end of this document you will find operating system-specific examples of the 
LOC86 controls. Fold out the pages containing the examples relevant to your 
operating environment and use them in conjunction with the syntax conventions 
provided in this chapter. 
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LOC86 
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Table 5-1. Summary of LOC86 Controls 



Control 


Abbrev. 


Default 


ADDRESSES! 

{ SEG M ENTS( isegment[ \ class [ \ overfay]] 

(ac/dr)} [,...]) 1 
CLASSES({c/ass(a(y(yr)} [,...]) | 
GROUPS({flffoup(a£/dr)>[,...]) > 
I.-]) 


AD 
(SM| 
CS 1 GR) 


Not applicable 


BOOTSTRAP 


BS 


Not applicable 


COMMENTS 


CM 


COMMENTS 


NOCOMMENTS 


NOCM 


INITCODE[(a(/(yress)] 


IC 


INITCODE(200H) 


NOINITCODE 


NOIG 


LINES 


LI 


LINES 


NOLINES 


NOLI 


MAP 


MA 


MAP 


NOMAP 


NOMA 


UAMEimodule) 


NA 


Not applicable 


OBJECTC0NTR0LS( 

{LINES 1 NOLINES | 
COMMENTS 1 NOCOMMENTS | 
SYMBOLS 1 NOSYMBOLS | 
PUBLICS 1 NOPUBLICS | 
PURGE 1 NOPURGE>(,...]) 


OC 


Not applicable 


ORDER( 

<:SEGMENTS({seflrme/i/( \cfass[\ overlay]]} 
[.-1)1 

CL^SSES{{.class[{segme^t [....])]> [....])> [,...]) 


OD 
(SM 1 CS) 

CS 


Not applicable 


PRINT[(paf/>/7a/ne)] 


PR 


PRINT(o6yec^ fileMPl) 


NOPRINT 


NOPR 


PRINTCONTROLS({ LINES | NOLINES | 

COMMENTS 1 NOCOMMENTS | 
SYMBOLS 1 NOSYMBOLS | 
PUBLICS 1 NOPUBLICS | 
PURGE 1 NOPURGE>[....]) 


PC 


Not applicable 


PUBLICS 


PL 


PUBLICS 


NOPUBLICS 


NOPL 


PURGE 


PU 


NOPURGE 


NOPURGE 


NOPU 


RESERVE( {arfd/- TO adc//-} [,...]) 


RS 


Not applicable 


SEGS\ZE(<.segment[\class[\overlay]] 

(size)y [,...]) 


SS 


Not applicable 


SJMlHsymbol \ paragraph, off seO) 


ST 


Not applicable 


SYMBOLS 


SB 


SYMBOLS 


NOSYMBOLS 


NOSB 


SYMB0LC0LUMNS({1I2I3I4>) 


SC 


SYMB0LC0LUMNS(2) 
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ADDRESSES 



Syntax 

ADDRESSES ({SEGMENTS i {segment name[\class name 

[\overlay name]] (address) } 

[,...]) I 

C LASSES (icfass name (address) }[,...]) | 
GROUPS ({group name(address)}[, ...])} 
[,...] 

) 



Abbreviation 
AD(SM|CS|GR) 

Default 

Not applicable 

Definition 

ADDRESSES allows you to override LOC86's default address assignment 
algorithm. You may assign a beginning address to segments, classes, or groups. All 
addres.ses must follow Intel rules for integer representation. (These rules are the 
same as those used by ASM86 and PL/M-86.) The subcontrols, SEGMENTS, 
CLASSES, and GROUPS, identify exactly what elements of the input module are 
being assigned addresses. When assigning an address with the SEGMENTS sub- 
control, you may also specify the class name and overlay name of the particular 
segment. 

LOC86 attempts to detect and avoid conflicts whenever possible. If the specified 
address does not agree with the alignment attribute of the specified segment or the 
first segment in the specified class, then the address is ignored. If an absolute seg- 
ment is located at the address assigned to a class, then the class begins at the first free 
address after the absolute segment. If you assign a non-paragraph address to a 
group, LOC86 will assign the first paragraph address below the specified address. 



Notes 

• The subcontrols SEGMENTS, CLASSES, and GROUPS can be specified 
multiple times in a single ADDRESSES control. 

• If an address assignment causes a conflict with an ORDER control, a 
RESERVE control or an absolute segment, LOC86 generates an error message. 

• When locating bound object modules, you may not assign an address to a 
segment in a group. 



5-3 



BOOTSTRAP 
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Syntax 
BOOTSTRAP 

Abbreviation 
BS 

Default 

Not applicable 

Definition 

BOOTSTRAP indicates that the code for a long jump to the module's start address 
should be placed at location OFFFFOH, when the module is loaded. This is the first 
instruction executed by the 8086 after reset. If the input module has no start address 
and none is specified in the START control, LOC86 will generate an error message. 

Notes 

• See also the START and INITCODE controls. 
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COMMENTS/NOCOMMENTS 



Syntax 

COMMENTS 
NOCOMMENTS 



Abbreviation 
CM 

NOCM 



Default 
COMMENTS 



Definition 

COMMENTS allows object file comment records to remain in the output module. 
The NOCOMMENTS control removes all comment records except those designated 
as non-purgable. 

Comment records are added to the object module for various reasons. All 
translators add a comment record to the object files they produce. The record iden- 
tifies the compiler or assembler that produced the object file. 

Comment records are superfluous to the production of executable code and may be 
removed at any time during the development process, or left in the file. 

Notes 

• See PRINTCONTROLS, OBJECTCONTROLS, and PURGE. 

• Comment records should not be removed when you submit an object file in a 
Software Problem Report. 

• NOCOMMENTS will decrease the size of the output object module. 

• COMMENTS has no effect on the print file. 
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Syntax 

IN ITCODE[ (acfcfress)] 
NOINITCODE 



Abbreviation 



IC 

NOIC 



Default 



INITCODE(200H) 



Definition 

INITCODE causes LOC86 to create a new segment that contains code to initialize 
the segment registers. The optional address argument specifies the physical address 
of the code that performs this initialization. If no address is specified, the initializa- 
tion code will be placed at 200H. The equivalent assembly language code is shown 
below: 



STACKFRAME 


DU 


stack frame 


DATAFRAME 


DU 


data frame 


EXTRAFRAME 


DU 


extra frame 




CLI 






MOV 


SS, CSrSTACKFRAME 




MOV 


SP, stack offset 




MOV 


DS, CS:DATAFRAME 




MOV 


ES, CS:EXTRAFRAME 




JMP 


program start 



Notes 

• The initialization code segment is created only if a register initialization record 
for 8086 segment registers exists in the input. These register initialization 
records are automatically produced by 8086-based translators for main 
modules. 

• If the area of memory used by the INITCODE default is reserved, LOC86 
places the initialization code above the reserved space. 

• If created, the new segment is called ??LOC86_INITCODE. 



5-6 



iAPX 86,88 Family Utilities 



LINES/NOLINES 



Syntax 

LINES 
NOLINES 

Abbreviation 

LI 

NOLI 

Default 

LINES 

Definition 

LINES allows line number information to remain in the object file. In-circuit 
emulators and other debuggers use this information; it is not needed to produce 
executable code. The NOLINES control removes this information from the output 
file. 

Notes 

• The scope of the LINES control can be modified with PRINTCONTROLS and 
OBJECTCONTROLS. 

• See the PURGE control . 

• NOLINES will decrease the size of the output object file. 
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Syntax 

NAP 
NONAP 



Abbreviation 
MA 

NOKA 



Default 
HAP 



Definition 

MAP causes LOC86 to produce a locate map for the output module and add it to the 
print file. For all segments in the module the map shows the complete name (seg- 
ment name, class name, and overlay name), size, alignment, start address, and stop 
address. A more complete description of the locate map and the rest of the print file 
is at the end of this chapter. 



Notes 

• MAP can be overridden by the NOPRINT control. 
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INI El 



Syntax 

NAME {.module name ) 



Abbreviation 
NA 

Default 

Module retains its current name. 
Definition 

NAME assigns the specified module name to the output module. If NAME is not 
specified, then the output module retains its current name. 

The module name may be up to 40 characters long. It may be composed of any of 
the following characters in any order: 

? (question mark) 
@ (commercial at) 
: (colon) 
. (period) 

(underscore) 

A, B, C, Z 
0,1,2, ...,9. 

Lower case letters may be used, but they are automatically converted to upper case. 



Notes 

• NAME does not affect the output file's name, only the module name in the 
output module's header record. 
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Syntax 

OBJECTCONTR0LS({LINES | NOLINES | 

COMMENTS I NOCOMMENTS \ 
SYMBOLS I NOSYMBQLS | 
PUBLICS I NOPUBLICS j 
PURGE j NOPURGE} 
[,...] 

) 



Abbreviation 



OC 



Default 

Controls apply to both the print file and the object file. 



Definition 

OBJECTCONTROLS causes the controls specified in its arguments to be applied to 
the object file only. Comment records, line number records, local and public symbol 
records, and symbol type records are selectively included or excluded from the 
object file. This will not affect the print file and the information contained in it. 



Notes 

• If you specify an invalid control in the arguments to OBJECTCONTROLS, 
LOC86 generates an error message. 

• You may specify a control or control pair more than once within 
OBJECTCONTROLS, but only the last version specified counts. 

• You may abbreviate the controls used within OBJECTCONTROLS . 

• When you specify a control in both OBJECTCONTROLS and 
PRINTCONTROLS, it will have the same effect as specifying it once outside of 
these controls. 
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ORDER 



Syntax 

ORDER({SEGMENTS( {segment name[\class name[\overlay name]] } 
[,•••]) I 

ZlkSSES i\{class name[isegment name [,...])]> [,...])} 
[,.-]) 

Abbreviation 
OD(SM|CS|) 

Default 

Not applicable 

Definition 

ORDER specifies a partial or complete order for segments, classes, and the segments 
within a class. Segments and classes listed in ORDER are located before any other 
relocatable segment. 

The subcontrol SEGMENTS indicates that the list of segment names shall be 
ordered. 

The segment name identifies the specific segments to be ordered. The \class name 
and \overlay name may be used to resolve conflicts with duplicate segment names. 
If \overlay name is specified, the \class name is required. 

If one of the segments specified is not contained in the designated group, an error 
message is generated. 

Notes 

• See "LOC86's Algorithm for Locating Segments" at the end of this chapter. 
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Syntax 

PRINT[(paf/ina/7ie)] 
NOPRINT 



Abbreviation 
PR 

NOPR 



Default 

PRINT (o/yecf ///e.MP2) 



Definition 

PRINT allows you to direct the locate map symbol table and other diagnostic 
information to a particular file. If the PRINT control is not specified or if the con- 
trol is given without an argument, the print file will have the same pathname as the 
output file except the extension will be .MP2. NOPRINT prevents the creation of 
this file. 



Notes 

• The discussion at the end of this chapter describes the contents of the print file. 

• See also MAP, SYMBOLCOLUMNS, LINES, SYMBOLS, PUBLICS, and 
PRINTCONTROLS. 
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Syntax 

PRINTCONTROLS(<LINES | NOLINES | 

COMMENTS I NOCOMMENTS | 
SYMBOLS I NOSYMBOLS | 
PUBLICS I NOPUBLICS | 
PURGE I N0PUR6E} 

) 

Abbreviation 
PC 

Default 

Controls apply to both the print file and the object file. 
Definition 

PRINTCONTROLS causes the controls specified in its arguments to be applied to 
the print file only. Line number information, and local and public symbol informa- 
tion are selectively included or excluded from the print file. This will not affect the 
object file or the information contained in it. 



Notes 



If you specify an invalid control in the arguments to PRINTCONTROLS, 
LOC86 generates an error message. 

You may specify a control in OBJECTCONTROLS more than once, but only 
the last version specified counts. 

You may abbreviate the controls used within PRINTCONTROLS. 

When you specify a control in both PRINTCONTROLS and 
OBJECTCONTROLS, it will have the same effect as specifying it once outside 
of these controls. 
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Syntax 

PUBLICS 
NOPUBLICS 

Abbreviation 
PL 

NOPL 

Default 
PUBLICS 

Definition 

PUBLICS causes the public symbol records to be kept in the object file and the 
corresponding information to be placed in the print file. 

Notes 

• The scope of PUBLICS can be modified by PRINTCONTROLS and 
OBJECTCONTROLS. 

• NOPUBLICS will reduce the size of the output object file; however, public 
symbol records are used by debuggers. 

• See the PURGE control. 



5-14 



iAPX 86,88 Family Utilities 



PURGE/NOPURGE 



Syntax 

PURGE 
NOPURGE 



Abbreviation 

PU 

NOPU 



Default 
NOPURGE 



Definition 

PURGE is exactly the same as specifying NOLINES, NOSYMBOLS, 
NOCOMMENTS, and NOPUBLICS. NOPURGE in the control list is the same as 
specifying LINES, SYMBOLS, COMMENTS, and PUBLICS. 

PURGE removes all of the public and debug information from the object file and 
the print file. It will produce the most compact object file possible. The records that 
would be included by NOPURGE are useful to debuggers and in-circuit emulators, 
but otherwise they are unnecessary for producing executable code. 



Notes 

• PRINTCONTROLS and OBJECTCONTROLS can be used to modify the 
scope of PURGE. 
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Syntax 

RESERVE ({aofcfressy TO address2} [,...]) 

Abbreviation 
RS 

Default 

All of memory is assumed available. 
Definition 

RESERVE prevents LOC86 from locating segments in certain areas of memory. 
LOC86 will not use all memory addresses from addressl to address2 inclusive; 
addressi must be less than or equal to address2. 

Notes 

• If an absolute segment uses a reserved memory area, a warning message is 
generated - 

• Reserved areas may overlap. 
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SEGSIZE 



Syntax 

SEGSIZE( isegment name[\class name[\overlay name]] ( size ) } 

Abbreviation 

SS 

Default 

Not applicable 

Definition 

SEGSIZE allows you to specify the memory space used by a segment. 

The segment name may be any segment contained in the input module. 

The size is a 16-bit number that LOC86 uses to change the size of the specified seg- 
ment. There are three ways of specifying this value: 

• + indicates that the number should be added to the current segment length. 

• — indicates that the number should be subtracted from the current segment 
length. 

• No sign indicates that the number should become the new segment length. 
Notes 

• LOC86 issues a warning message when SEGSIZE decreases the size of a 
segment. 
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S T A R T ( ipublic symbol \ paragraph , offset"} ) 
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Abbreviation 
ST 

Default 

The start address designated in the input module 
Definition 

START allows you to specify the start address of your program. 

If you specify public symbol, that symbol must be defined within the input module. 

The paragraph value initializes the CS register and the offset value initializes the IP 
in an 8086 long jump when your program is started. 

Notes 

• See the BOOTSTRAP and INITCODE controls. 
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SYMBOLS/NOSYMBOLS 



Syntax 

SYMBOLS 
NOSYMBOLS 

Abbreviation 
SB 

NOSB 

Default 
SYMBOLS 

Definition 

SYMBOLS specifies that all local symbol records shall be included in the object file, 
and information concerning local symbols will also appear in the symbol table con- 
tained in the print file. Local symbol records are used by debuggers and in-circuit 
emulators. 

Notes 

• The scope can be modified by OBJECTCONTROLS and PRINTCONTROLS. 

• NOSYMBOLS will decrease the size of the output object file. 

• See the PURGE control. 
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Syntax 

SYMB0LC0LUMNS({1 |2|3|4>) 

Abbreviation 
SC 

Default 

SYMB0LC0LUMNS(2) 
Definition 

SYMBOLCOLUMNS indicates the number of columns to be used when producing 
the symbol table for the object module. Two columns fit on a 78-character line; four 
columns fit on a single 1 28-character line printer line. 

Notes 

None 
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LOC86 



LOC86's Print File 

The print file is always created unless you specify NOPRINT. The optional argu- 
ment to PRINT designates the name of the print file. The default print file is the 
object file with the extension .MP2. 

The print file may contain as many as three parts: 

• A symbol table 

• A memory map 

• An error message list 

The symbol table is included in the print file when a PUBLICS, LINES, or 
SYMBOLS control is in effect. The memory map is controlled by the 
MAP/NOMAP control. Error and warning messages, if any, are always added to 
the print file. 



The Symbol Table 

LOC86 produces a symbol table when any or all of the symbol controls (LINES, 
SYMBOLS, and PUBLICS) are in effect. No symbol table will be produced when 
PURGE is in effect for the print file. 

Figure 5-2 shows LOC86's symbol table with the SYMBOLCOLUMNS set at 2 (the 
default). 

BASE is usually a 4-digit hexadecimal number that is the base address of the group 
that contains the symbol. If the base is the stack, then STACK is used instead of a 
number. If the symbol is based on another symbol's value, then the BASE and 
OFFSET values for that symbol are given. 

OFFSET is a 4-digit hexadecimal number that is the offset of the symbol or line 
from BASE, or from the current BP for stack symbols. 

To compute the physical address of the specified symbol you would use the follow- 
ing equation: 

(BASE * lOH) + OFFSET = Physical Address 

Of course, the physical address of the symbols whose base is the STACK, or symbols 
that are based on another symbol's value, cannot be computed until run-time. 

TYPE describes the kind of symbol it is. There are four possible entries in the TYPE 
column: 

B A S based on another symbol' s value 
L I N line (not a symbol) 
PUB public symbol 
SYN local symbol 

SYMBOL field contains the name of the symbol or number of the line. If the 
SYMBOLCOLUMNS value is 1, this field is 40 characters wide. If the 
SYMBOLCOLUMNS value is 2 or more, then this field is 16 characters wide. If the 
symbol name is longer than the width of the entry, then the name is hyphenated and 
continued in the SYMBOL field on the next line. 
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system-id HQUb LOCATER, Vx.y 

INPUT FILE: pathnamel 
OUTPUT FILE: pathnameZ 

CONTROLS SPECIFIED IN INVOCATION COMMAND: 
DATE: MM/DD/YY TIME: HH:MM:SS 



SYMBOL TABLE OF MODULE ROOT 



BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


OOBbH 


016CH 


PUb 


BINDCONTROL 


OOBBH 


0052H 


PUB 


BNODEBASE 


OOBBb 


OOlEh 


PUB 


BUF6ASE 


OOBbH 


001CH 


PUB 


BUFLEN 


OOBBH 


0054H 


PUB 


CLASHNOOEBASE 


OOBBh 


0066H 


PUB 


COCOMN 


OOBBH 


0160H 


PUb 


COHMEMISCONTROL 


OOBBH 


0177H 


PUB 


CURRENTOTBRLAXNU 


OOBBH 


0179H 


PUB 


OEBUGTOGGLE 


OOBBH 


OOACfi 


PUB 


-M 

DEFAULTPRTFILENA 


OObBH 


0068H 


PUB 


EXCEPTION 


OOBBH 


004EH 


PUB 


-ME 
FANOOEBASE 


OOBBH 


0074H 


PUB 


FBLOCKBASE 


OOBBB 


0070U 


PUB 


FBLOCKLISTbEAO 


OOBBH 


0072H 


PUB 


FBLGCKLISITAIL 


OOBBH 


01'I3U 


PUB 


FBLOCKSEQUENCENU 
















-MBER 


OOBBH 


0050H 


PUB 


FBNODEBASE 


OOBBH 


OOtCH 


PUB 


FDNODEBASE 


OOBBH 


004AH 


PUB 


FENODEBASE 


OOBBH 


0046H 


PUB 


FFNODEBASE 


OOBBH 


003AH 


PUB 


FIRSTBNODEP 


OOBBH 


002EH 


PUB 


PiaSTEXNODEP 


OOBBH 


0032H 


PUB 


FIRSTGRNOOEP 


OOBBH 


0022H 


PUB 


FIRSTNMNOOEP 


OOBBH 


0036H 


PUB 


FIRSTOVHODEP 


OOBBH 


0056H 


PUB 


FIRSTRENAHGBLOCK 


OOBBH 


0026H 


PUB 


FIRSTSGNOOEP 


OOBBH 


002AH 


PUB 


-P 

FIfiSTTONODEP 


OOBBB 


003EH 


PUB 


GRNODEBASE 


OOBBB 


0B52H 


PUB 


HIGHESTDATALOCAT 



-ION 




MODULE s ROOT 



BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


OOBBH 


OFAOH 


SYM 


MEMORY 


OOBBH 


0006H 


SYM 


COPYRIGHT 


OOBBH 


001CH 


SYM 


BUFLEN 


OOBBH 


001EH 


SYM 


BUFBASE 


0020H 


00F7H 


SYM 


ERROR 


0020H 


OOFEH 


SYM 


WARNING 


OOBBH 


0020H 


SYM 


LASTNHNODEP 


OOBBH 


0022H 


SYM 


FIRSTNMNODEP 


OOBBH 


0024H 


SYM 


LASTSGNOOEP 


OOBBH 


0026H 


SYM 


FIRSTSGNODEP 


OOBBH 


0028H 


SYM 


LASTTBNOOEP 


OOBBH 


002AH 


SYM 


FIRSTIDNODEP 


OOBBH 


002CH 


SYM 


LASTEXNODEP 


OOBBH 


002EH 


SYM 


FIRSTEXNODEP 


OOBBH 


OO3OH 


SYM 


LASTGRNODEP 


OOBBH 


0032H 


SYM 


FIRSTGRNODEP 


OOBBH 


0034H 


SYM 


LASTOVNODEP 


OOBBH 


0036H 


SYM 


FIRSTOVNODEP 


OOBBH 


OO38H 


SYM 


LASTBNODEP 


OOBBH 


003AH 


SYM 


FIRSTBNODEP 


OOBBH 


003CH 


SYM 


SGNODEBASE 


OOBBH 


003EH 


SYM 


GRNODEBASE 


OOBBH 


0040H 


SYM 


SYNODEBASE 


OOBBH 


0042H 


SYM 


NMNODEBASE 


OOBBH 


0041tH 


SYM 


TDNODEBASE 


OOBEH 


001I6H 


SYM 


FFNODEBASE 


OOBBH 


0048H 


SYM 


OVNODEBASE 


OOBBB 


004AH 


SYM 


FENODEBASE 


OOBBH 


004CH 


SYM 


FDNODEBASE 


OOBBH 


004EH 


SYM 


FANODEBASE 


OObBH 


0050H 


SYM 


FBNODEBASE 


OOBBH 


0052H 


SYM 


BNODEBASE 


OOBBb 


0054b 


SYM 


CLASHNOOEBASE 


OOBBH 


OOSbH 


SIM 


FIRSTRENAMEBLOCK 



-p 




OOBBH 


01 AAH 


SYM 


SIGNONMSG 


0020H 


0174H 


SYM 


PRINTNAHE 


0020H 


01 A3H 


SYM 


INITIALIZEINPUT 


0020H 


01A8H 


SYM 


OPENFBLOCKFILE 


0020H 


01 F6H 


SYM 


CLOSEFBLOCKFILE 


0020H 


00F7H 


LIN 


7 


0020H 


OOFAH 


LIN 


10 


0020H 


OOFEH 


LIN 


1 1 


0020H 


0101H 


LIN 


14 


0020H 


0105H 


LIN 


73 


0020H 


0108H 


LIN 


75 


0020H 


010FH 


LIN 


76 


0020H 


ont)H 


LIN 


77 


0020H 


011DH 


LIN 


78 


0020H 


0126H 


LIN 


79 


0020H 


012AH 


LIN 


80 


0020H 


012DH 


LIN 


84 


0020b 


0136H 


LIN 


85 


0020h 


013Dh 


LIN 


b6 


0020H 


0144H 


LIN 


87 


0020U 


OI5IH 


LIN 


tJb 


0020b 


015AH 


LIN 


89 


0020U 


0 looh 


LIN 


90 


0020H 


OI7OH 


LIN 


91 


0020h 


0174H 


LIN 


94 


0020b 


0177H 


LIN 


96 


0020h 


01 UEb 


LIN 


97 


0020b 


019t)H 


LIN 


98 


0020b 


0 19FH 


LIN 


99 


0020H 


01A3H 


LIN 


100 


0020H 


OlAbh 


LIN 


103 


0020H 


QIAdH 


LIN 


105 




Figure 5-2. LOC86 Symbol Table 
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The Memory Map 

The memory map supplies useful information about segment placement and address 
assignment. Figure 5-3 shows LOC86's memory map. 

The map consists of three parts: 

• Header 

• Segment map 

• Group map 

The header includes the input module name and the start address. 

The segment map is a table with six columns. From left to right the columns show: 

• the START address of the segment 

• the STOP address of the segment 

• the LENGTH of the segment 

• the ALIGNMENT attribute of the segment 

• the NAME of the segment 

• the CLASS of the segment 

• the OVERLAY of the segment 

A "C" printed between the STOP and LENGTH columns indicates that two 
segments have overlapping memory locations; a warning message is also issued. 

A segment may have any one of the following alignment attributes: 

A absolute 

B byte 

G paragraph 

M member of an LTL group 

P page 

Vi word 

R in-page 



MENORI MAP OF MODULE ROOT 



MODULE START ADDRESS PARAGRAPH = 0020H OFFSET = 0002H 
SEGMBHT MAP 



START 


STOP 


LENGTH 


ALIGN 


NAME 


CLASS 


00200H 


00BB5H 


09B6H 


H 


CODE 


CODE 


OOBBbH 


OOBCBH 


0016H 


H 


CONST 


CONST 


OOBCCH 


01703B 


0B36H 


U 


DATA 


DATA 


01704U 


0 IBISH 


0442H 




STACK 


STACK 


01B50B 


01B50H 


OOOOU 


Q 


77SEG 




01BS0B 


01B50H 


OOOOH 


h 


HEHORX 


MGMORX 



ADDRESS GROUP OR SEGMENT NAME 
00200H CGROUP 

CODE 
OOBBOH DGROUP 

CONST 

DATA 

STACK 

MEMORX 




Figure 5-3. LOC86 Memory Map 
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In-page alignment means that the entire segment must be resident within a single 
256-byte page. The address of the first byte in any page has zeros in the first two 
hexadecimal digits ( OOH, lOOH, 200H, .. . OFFFOOH). 

The group map has two columns: the first is the physical address (five-digit hexa- 
decimal number) of the beginning of the group; the second column is the group 
name, followed by the segments contained in that group. The segment names con- 
tained within a given group are listed in the same column but indented slightly. 



Error and Warning Messages 

The error and warning messages are listed consecutively as the error situations are 
encountered. 

See the discussion of the interpretation of individual messages in Appendix F. 



LOC86's Algorithm for Locating Segments 

Assuming that there are no errors in the invocation line or input module, LOC86 
locates an input module in three stages. 

1 . All absolute segments are removed from the list of segments contained in the 
module. 

2. The remaining relocatable segments are ordered into a sequential list. 

3. The relocatable segments are then given absolute addresses according to each 
segment's alignment, size, and memory attribute. 



Absolute Segments 

When LOC86 encounters an absolute segment, LOC86 removes the segment from a 
list of input segments and reserves the memory area used by that segment. LOC86 
maintains a map of free memory. Each time an absolute segment is encountered, the 
memory space used by that segment is removed from the memory map. A segment 
can become absolute in one of three ways: 

1 . It may be assigned an absolute address by the translator. 

2. It may be explicitly specified in an ADDRESSES control. 

3. It may become absolute implicitly. If an absolute segment is specified in an 
ORDER control, then all other segments referred to in that control, either by 
segment name or by class name, are treated as absolute. 



Segment Ordering 

After all memory used by absolute segments has been removed from LOC86's free 
memory map and before LOC86 begins assigning addresses to the remaining 
relocatable segments, LOC86 prepares an ordered list of all relocatable segments. 

All relocatable segments specified in an ORDER control are placed at the head of 
the list. 
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After all ORDER controls, if any, have been processed, LOC86 adds the relocatable 
segments that remain to the end of the list. If the first segment not previously used 
has a class name, then all other segments with the same class name are added to the 
list. After all segments of the class have been added to the list, then the next segment 
is added to the list. 

This process continues until all segments have been added to the ordered list. 



NOTE 

Memory segments do not adhere to this process — a memory segment is 
always located at the top of memory, if possible. If an input module con- 
tains more than one memory segment, only the first is placed at the top of 
memory; the other segments are treated as any other relocatable segment. 



Assigning Addresses to Relocatable Segments 

Once LOC86 completes the ordered list of relocatable segments, it begins assigning 
addresses. LOC86 will never assign addresses that conflict with the location of 
absolute segments or the RESERVE control or between OOH and 200H, since that 
area is reserved for interrupt routines. 

Starting at location 200H, LOC86 scans free memory to find an area in which the 
first segment will fit. When LOC86 finds a suitable address, it assigns it to the seg- 
ment and removes that area from free memory. LOC86 then scans free memory for 
an area that will fit the next segment in the ordered list. LOC86 begins scanning at 
the end of the previous segment. 

IF LOC86 reaches the end of memory and all of the relocatable modules have not 
been located, it makes an additional scan through free memory. The scanning pro- 
cess continues until all modules have been located. 



LOC86's Algorithm for Locating Modules 
Containing Overlays 

LOC86 locates programs with overlays in much the same way as it handles programs 
that do not contain overlays. However, there are some differences. 

1 . Segments contained in the root and each overlay are ordered separately. 

2. Segments that are common to both the root and overlays (e.g., STACK and 
MEMORY) are put at the end of the list of relocatable segments. 

3. Segments in the root are located at the lowest available addresses in memory. 

4. Segments contained in the overlays are located at the first available address 
above the root. 

5. Segments common to the root and overlays are located immediately above the 
largest overlay in the file. 

Figure 5-4 illustrates how LOC86 treats two PL/M-86 programs that use overlays. 
Figure 5-4a shows how segments are located when the modules are compiled with the 
LARGE model. Figure 5 -4b shows how segments are located when the modules are 
compiled with the SMALL model of segmentation. 
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ROOT 



OVERUVY 1 



OVERLAY 2 




CLASS DATA 



a. LARGE Model 



Figure 5-4. LOC86's Address Assignments for Overlays 1216I6-7 
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ROOT 



CODE 



OVERLAY 1 




OVERLAY 2 



CODE 



} 



C GROUP 



CONST 



STACK 



CONST 



DATA 



CONST 



DATA 



STACK 



D GROUP 



MEMORY 



STACK 



MEMORY 



MEMORY 



CS- 



DS.SS- 



SP- 



CODE FOR ROOT 



CODE FOR 
OVERLAY 1 



CODE FOR 
OVERLAY 2 



CONST FOR ROOT 



DATA FOR ROOT 



CONST FOR OVERLAY 1 



DATA FOR 
OVERLAY 1 



CONST FOR OVERLAY 2 



DATA FOR OVERLAY 2 




STACK 



MEMORY 



SIZE OF ROOT STACK 



MAXIMUM SIZE 
OVERLAY STACK 



MAXIMUM SIZE 
OF MEMORY (OVERLAY 1) 



C GROUP 



y D GROUP 



b. SMALL Model 



Figure 5-4. LOC86's Assignments for Overlays (Cont'd.) 
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OH86 converts 8086 absolute object modules to 8086 hexadecimal format. The 
input module must be in absolute format, and it may not contain overlays or register 
initialization records. 

Figure 6-1 illustrates the object-to-hexadecimal conversion process. Any errors 
encountered during execution are displayed at the console output device. 

For definition of file-naming conventions and syntax notation, refer to Notational 
Conventions following the Preface. For information on error and warning messages 
which may be produced, refer to Appendix H. 

The general syntax for the invocation line is: 

[directory-name]0WZ6 input file[10 output file] 

The input file contains an 8086 absolute object module. 

TO output file designates the file to receive the 8086 hexadecimal format. If output 
file is not specified, then output is directed to a file that has the same pathname as 
the input list, but its extension is HEX. 

At the end of this document you will find operating system-specific examples of the 
OH86 invocation. 



ABSOLUTE 
OBJECT 
MODULE 



OH86 



I 



ABSOLUTE 
HEX 
FILE 
".HEX" 



CONSOLE 
MESSAGES 



Figure 6-1. OH86 Input and Output Files 1216I6-9 
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Introduction 

The 8086 Absolute Object File Format herein described is a proper subset of the full 
8086 Object File Formats. An absolute object file consists of a sequence of records 
defining a single absolute module. An absolute module is defined as a collection of 
absolute object information that is specified by a sequence of object records. 



Definitions 

This section defines certain terms fundamental to 8086 Relocation and Linkage 
(R&L). The terms are ordered not alphabetically, but so you can read forward 
without forward references. 



Definition of Terms 

OMF— acronym for Object Module Formats 
R&L — acronym for Relocation and Linkage 

MAS — acronym for Memory Address Space. The 8086 MAS is one megabyte 
(1,048,576 bytes). Note that the MAS should be distinguished from actual memory, 
which may occupy only a portion of the MAS. 

MODULE — an "inseparable" collection of object code and other information pro- 
duced by a translator or by the LINK86 program. When a distinction must be made: 

T-MODULE— denotes a module created by a translator, such as PL/M-86 or 
ASM86, and 

L-MODULE — denotes a module created by LINK86 from one or more constituent 
modules. (Note that modules are not "created" in this sense by the iAPX86,88 
Locater, LOC86; the output module from LOC86 is merely a transformation of the 
input module). 

Two observations about modules must be made: 

1 . Every module must have a name, so that the iAPX86,88 Librarian, LIB86, has a 
handle for the module for display to the user. (If there is no need to provide a 
handle for LIB86, the name may be null.) Translators provide names for T- 
modules, providing a default name (possibly the file name or a null name) if 
neither source code nor user specifies otherwise. 

2. Every T-module in a collection of modules linked together may have a different 
name, so that symbolic debugging systems can distinguish the various symbols. 
This restriction is not required by R&L and is not enforced by it. 

FRAME — a contiguous region of 64K of MAS, beginning on a paragraph boundary 
(i.e., on a multiple of 16 bytes). This concept is useful because the content of the 
four 8086 segment registers define four (possibly overlapping) FRAME's; no 16-bit 
address in the 8086 code can access a memory location outside of the current four 
FRAME'S. The FRAME starting at address OOOOH is FRAME 0. 
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Module Identification 



In order to determine that a file contains an object program, a module header record 
will always be the first record in a module. There are two kinds of header records 
and each provides a module name. The additional functions of the header records 
are explained below. 

A module name may be generated during one of two processes: translation or link- 
ing. A module that results from translation is called a T-MODULE. A T-MODULE 
will have a T-MODULE HEADER RECORD (THEADR). A name may be 
provided in the THEADR record by a translator. This name is then used to identify 
the progenitor of all debug information found in the T-MODULE. The name may 
be null, i.e., of length zero. 

A module that results from linking and locating is called an L-MODULE. An 
L-MODULE will always have an L-MODULE HEADER RECORD (LHEADR) or 
an R-MODULE HEADER RECORD (RHEADR). In the LHEADR or RHEADER 
record a name is also provided. This name is available for use to refer to the module 
without using any of its constituent T-MODULE names. An example would be two 
T-MODULES, A and B, linked together to form L-MODULE C. L- MODULE C 
will contain two THEADR records and will begin with an LHEADR record with the 
name C provided by the linker as a directive from the user. The L- MODULE C can 
be referred to by other tools such as the library manager without having to know 
about the originating module's names, yet the originating module's names are 
preserved for debugging purposes. 



Module Attributes 



In addition to a name, a module may have the attribute of being a main program as 
well as having a specified starting address. 

If a module is not a main module yet has a starting address, then this value has been 
provided by a translator, possibly for debugging purposes. A starting address 
specified for a non-main module could be the entry point of a procedure, which may 
be loaded and initiated independent of a main program. 



Physical Segment Definition 

A module is defined as a collection of data bytes defined by a sequence of records 
produced by a translator. The data bytes represent contiguous regions of memory 
whose contents are determined at translation time. 



Physical Segment Addressability 

The 8086 addressing mechanism provides segment base registers from which a 64K 
byte region of memory, called a Frame, may be addressed. There is one code seg- 
ment base register (CS), two data segment base registers (DS, ES), and one stack seg- 
ment base register (SS). 
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Data 

The data that defines the memory image represented by a module is maintained in 
two varieties of DATA records: PHYSICAL ENUMERATED DATA RECORD 
(PEDATA) and PHYSICAL ITERATED DATA RECORD (PIDATA). Both 
records specify the data to be loaded into a contiguous section of memory. The start 
address of this contiguous section is given in the record. PEDATA records contain 
an exact byte-by-byte copy of the desired memory image. The PIDATA record dif- 
fers in that the data bytes are represented within a structure that must be expanded 
by the loader. The purpose of the PIDATA record is to reduce module size by 
encoding repeated data rather than explicitly enumerating each byte, as the 
PEDATA record does. 



Record Syntax 



The following syntax shows the valid orderings of records to form an absolute 
module. In addition, the given semantic rules provide information about how to 
interpret the record sequence. The syntactic description language used herein is 
defined in Wirth: CACM, November 1977, V20, N 11, pg. 822-823. 



absol ute_object_f i I e 

module 

tmod 

imod 

omod 

o_component 
l_component 
content_def 
mod_tail 



=module. 

=tmod I Imod I omod. 

=THEADR [REGINT]content_def mod_tail. 

=LHEADR [REGINT]t_component mod_tail. 

=RHEADR {0VLDEF>[REG1NT] o_component 
COVLDEF> mod_tail. 

=t_component ENDREC. 

=[THEADR] content_def 

=PEDATA i PIDATA. 

=[REGINT] MODEND. 



NOTE 

The character strings represented by capital letters above are not literals but 
are identifiers that are further defined in the section defining the Record 
Formats. 

One module may not contain more than one REGINT record and more than one 
OVLDEF sequence. If a REGINT record and an OVLDEF sequence exist, the 
REGINT record must immediately follow the OVLDEF sequence. 

A proper Absolute Object File produced by Intel products will contain at least the 
above record types. It may also contain other record types which, if present, will 
follow the Module Header record and precede the Module End record. These other 

record types fall into two categories: 

1. Extraneous, containing information not pertinent to an absolute loader. The 
record numbers in this category are: 

72H, 74H, 7AH, 7CH, 7EH, 88H, 8CH, 8EH, 90H, 92H, 94H, 96H, 98H, 9AH, 9CH 

2. Erroneous, containing information about relocation, indicating that the object 
module is not yet in absolute form or that erroneous record types exist. The 
record numbers in this category are all other recprd type numbers. 
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Record Formats 



The following pages present diagrams of Record Formats in schematic form. Here is 
a sample, to illustrate the various conventions: / 



Sample Record Format (SAMREC) 



REC 


RECORD 




TYP 


LENGTH 




xxH 









CHK 




SUM 



L,.J 



Title and Official Abbreviation 

At the top is the name of the Record Format described, together with an official 
abbreviation. To promote uniformity among various programs, the abbreviation 
should be used in both code and documentation. The abbreviation is always six 
letters. 



The Boxes 

Each format is drawn with boxes of two sizes. The narrow boxes represent single 
bytes. The wide boxes represent two bytes (or one word) each. In the object file, the 
low order byte of a word value comes first. The wide boxes with four vertical bars in 
the top and bottom represent 4-byte fields. The wide boxes with three dots in the top 
and bottom represent a variable number of bytes, one or more, depending upon 
content. 



Rec Typ 

The first byte in each record contains a value between 0 and 255, indicating the type 
of record. 



Record Length 

The second field in each record contains the number of bytes in the record, exclusive 
of the first two fields. 



Name 

Any field that indicates a "NAME" has the following internal structure: the first 
byte contains a number between 0 and 40, inclusive, that indicates the number of 
remaining bytes in the field. The remaining bytes are interpreted as a byte string; 
each byte must represent the ASCII code of a character drawn from this set: 

[?@ :._0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ ] 

Most translators will choose to constrain the character set more strictly; the above 
set has been chosen to "cover" that required by all current processors. 
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Repeated Fields 

Some portions of a Record Format contain a field or series of fields that may occur 
an indefinite number of times (zero or more). Such fields are indicated by the 
"repeated" or **rpt'* brackets below the boxes. 

Similarly, some portions of the Record Format are present only if some given condi- 
tion obtains; these fields are indicated by similar * 'conditional" brackets below the 
boxes. 



Chk Sum 

The last field in each record is a check sum, which contains the two's complement of 
the sum (modulo 256) of all other bytes in the record. Therefore, the sum (modulo 
256) of all bytes in the record equals 0. 



Bit Fields 

Descriptions of contents of fields will sometimes get down to the bit level. Boxes 
with vertical lines drawn through them represent bytes or words; the vertical lines in- 
dicate bit boundaries; thus this byte has three bit-fields of three, one, and 
four bits: 



1 1 




1 1 1 


1 1 




1 1 1 



Ignored Records 



REC 
TYP 



RECORD 
LENGTH 



IGNORE 
THIS 
PART 



CHK 
SUM 



All record types that may be in an object module that provide information not perti- 
nent to an absolute loader must be ignored. They may all be treated as if they have 
the above format. Records in this category have REC TYP in the set 72H, 74H, 
7AH, 7CH, 7EH, 88H, 8CH, 8EH, 90H. 92H, 94H, 96H, 98H, 9AH, 9CH. 



T-Module Header Record (THEADR) 



REC 
TYP 

80H 



RECORD 
LENGTH 



T 

MODULE 

NAME 



CHK 
SUM 



Every module output from a translator must have a T-MODULE HEADER 
RECORD. Its purpose is to provide the identity of the original defining module for 
all debug information encountered in the module up to the following T-MODULE 
HEADER RECORD or MODULE END RECORD. 



This record can also serve as the header for a module; i.e., it can be the first record 
and will be for modules that are output from translators. 
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T-Module Name 

The T-MODULE NAME provides a name for the T-MODULE. 

L-Module Header Record (LHEADR) 



REC 


RECORD 


L 


CHK 


TYP 


LENGTH 


MODULE 


SUM 


82H 




NAME 





A module created by LINK86 and LOC86 may have an L-MODULE HEADER 
RECORD. This record serves only to identify a module that has been processed 
(output) by LINK86 and/or LOC86. When several modules are linked to form 
another module, the new module requires a name, perhaps unique from those of the 
linked modules, by which it can be referred to (by the LIB86 program, for example). 



L-Module Name 

The L-MODULE NAME provides a name for the L-Module. 
R-MODULE HEADER RECORD (RHEADR) 



REC 


RECORD 


R-MODULE 


OVERLAY 


CHK 


TYP 


LENGTH 


NAME 


INFO 


SUM 


6EH 











Every module with overlays created by LINK86/LOC86 will have an R-MODULE 
HEADER RECORD. This record serves to identify a module that has been pro- 
cessed (output) by LINK86/LOC86. It also specifies the overlay count and the loca- 
tion of the Overlay Definition records. When several modules are linked to form 
another module, the new module requires a name, perhaps unique from those of the 
linked modules, by which it can be referred to. 



R-MODULE NAME 

The R-MODULE NAME provides a name for the R-Module. 



OVERLAY INFO 

The OVERLAY INFO field provides information on overlays in the module and has 
the following format: 



IGNORE 
THIS 
PART 



OVERLAY 
RECORD 
COUNT 



I I h 



OVERLAY 
RECORD 
OFFSET 



IGNORE 
THIS 
PART 



The first subfield is a S-byte field that should be ignored. 
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The OVERLAY RECORD COUNT subfield indicates the number of Overlay 
Definition Records in the module. 



The OVERLAY RECORD OFFSET subfield is a 4-byte field. It contains a 32-byte 
unsigned number indicating the location in bytes, relative to the start of the object 
file, of the first Overlay Definition Record in the Module. 

The last subfield is a 16-byte field that should be ignored. 



OVERLAY DEFINITION RECORD (OVLDEF) 



REC 

TYP 
76H 



RECORD 
LENGTH 



OVERLAY 
NAME 



OVERLAY 
LOCATION 




This Record provides the overlay name, the location of the overlay in the object file. 

A loader may use this record to locate the data records of the overlay in the object 
file. 



OVERLAY NAME 



The OVERLAY NAME field provides a name by which a collection of data records 
may be referenced for loading. 



OVERLAY LOCATION 

The OVERLAY LOCATION is a 4-byte field which gives the location in bytes 
relative to the start of the file of the first byte of the records in the overlay. 



z 

The Z field is a reserved field. This field is required to be zero. 



END RECORD (ENDREC) 



REC 


RECORD 


END 


CHK 


TYP 


LENGTH 


TYP 


SUM 


78H 









This record is used to denote the end of a set of records such as records in an 
overlay. 
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ENDTYP 

This field specifies the type of the set. It has the following format: 















1 - 


0 


0 


0 


0 


0 


0 


TYP 














1 



TYP is a two bit subfield that specifies the following types of ends: 



TYP 

0 
1 
2 
3 



TYPE OF END 

End of overlay 
(Reserved) 
(Illegal) 
(Illegal) 



REGISTER INITIALIZATION RECORD (REGINT) 













REC 


RECORD 


REG 


REGISTER 


CHK 


TYP 


LENGTH 


TYP 


CONTENTS 


SUM 


70H 











• repeated ■ 



This record provides information about the 8086 registers/register-pairs: CS and 
IP, SS and SP, DS and ES. The purpose of this information is for a loader to set the 
necessary registers for initiation of execution. 



REG TYP 

The REG TYP field provides the register/register-pair name. It has the following 
format: 



REGID 


0 


0 


0 


0 


0 


0 



REGID is a two bit subfield that specifies the name of the registers/register-pairs as 
follows: 



REGID 



REGISTER/REGISTERPAIR 



CS and IP 
SS andSP 
DS 
ES 
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REGISTER CONTENTS 

The REGISTER CONTENTS field has the following format: 



z 


z 


FRAME 
NUMBER 


REGISTER 
OFFSET 




conditional 



The Z fields are reserved fields. They are required to be zero. 

The FRAME NUMBER field specifies a frame number that must be used to 
initialize the base register indicated by the REGID value. 

The REGISTER OFFSET field, present only if REGID <= 1, specifies an offset 
relative to the FRAME. This value is appropriate for the initialization of either the 
IP register (REGID = 0) or the SP register (REGID = 1). 



Module End Record (MODEND) 



REG 
TYP 
8AH 



RECORD 
LENGTH 



MOD 
TYP 



START 
ADDRS 



CHK 
SUM 



1_ 



conditional 



_l 



This record serves two purposes. It denotes the end of a module and indicates 
whether the module just terminated has a specified entry point for initiation of 
execution. If the latter is true, then the execution address is specified. 



Mod Typ 

This field specifies the attributes of the module. The bit allocation and their 
associated meanings are as follows: 



1 

MATTR 
1 


0 


0 


0 


0 


0 


0 



MATTR is a two-bit subfield that specifies the following module attributes: 



MATTR MODULE ATTRIBUTE 

0 Non-main module with no starting address 

1 Non-main module with starting address 

2 (invalid value for MATTR) 

3 Main module with starting address 
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Start Addrs 

The START ADRS field has the following format: 



FRAME 


OFFSET 


NUMBER 





FRAME NUMBER. This field specifies a frame number relative to which the 
module will begin execution. This value is appropriate for insertion into the CS 
register for program initiation. 

OFFSET. This field specifies an offset relative to the FRAME NUMBER that 
defines the exact location of the first byte at which to begin execution. This value is 
appropriate for insertion into the IP register for program initiation. 

Physical Enumerated Data Record (PEDATA) 



REC 


RECORD 


FRAME 


OFF 




CHK 


TYP 


LENGTH 


NUMBER 


SET 


DAT 


SUM 


84H 













This record provides contiguous data, from which a portion of an 8086 memory 
image may be constructed. 

Frame Number 

This field specifies a Frame Number relative to which the data bytes will be loaded. 
Offset 

This field specifies an offset relative to the FRAME NUMBER which defines the 
location of the first data byte of the DAT field. Successive data bytes in the DAT 
field occupy successively higher locations of memory. The value of OFFSET is con- 
strained to be in the range 0 to 15 inclusive. If an OFFSET value greater than 15 is 
desired, then an adjustment of the FRAME NUMBER should be done. 

Dat 

This field provides consecutive bytes of an 8086 memory image. The number of 
DAT bytes is constrained only by the RECORD LENGTH field. The address of 
each byte must be within the frame specified by FRAME NUMBER. 



Physical Iterated Data Record (PIDATA) 



REG 


RECORD 


FRAME 


OFF 


ITERATED 


CHK 


TYP 


LENGTH 


NUMBER 


SET 


DATA 


SUM 


86H 








BLOCK 





I reoeated 



repeated 

This record provides contiguous data, from which a portion of an 8086 memory 
image may be constructed. It allows initialization of data segments and provides a 
mechanism to reduce the size of object modules when there are repeated data to be 
used to initialize a memory image. 



A-10 



iAPX 86,88 Family Utilities 



iAPX 86,88 Absolute Object File Formats 



Frame Number 

This field specifies a frame number relative to which the data bytes will be loaded. 
Offset 

This field specifies an offset relative to the FRAME NUMBER which defines the 
location of the first data byte in the ITERATED DATA BLOCK. Successive data 
bytes in the ITERATED DATA BLOCK occupy successively higher locations of 
memory. The range of OFFSET is constrained to be between 0 and 15 inclusive. If a 
value larger than 15 is desired for OFFSET, then an adjustment of FRAME 
NUMBER should be done. 

Iterated Data Block 

This repeated field is a structure specifying the repeated data bytes. It is a structure 
that has the following format: 



REPEAT 


BLOCK 




COUNT 


COUNT 


CONTENT 



Repeat Count. This field specifies the number of times that the CONTENT portion 
of this ITERATED DATA BLOCK is to be repeated, and must be greater than zero. 

Block Count. This field specifies the number of ITERATED DATA BLOCKS that 
are to be found in the CONTENT portion of this ITERATED DATA BLOCK. If 
this field has value zero then the CONTENT portion of this ITERATED DATA 
BLOCK is interpreted as data bytes. 

If BLOCK COUNT is non-zero then the CONTENT portion of this ITERATED 
DATA BLOCK is interpreted as that number of ITERATED DATA BLOCKS. 

Content. This field may be interpreted in one of two ways, depending on the value 
of the previous BLOCK COUNT field. 

If BLOCK COUNT is zero, then this field is a one-byte count followed by the 
indicated number of data bytes. 

If BLOCK COUNT is non-zero, then this field is interpreted as the first byte of 
another ITERATED DATA BLOCK. 

NOTE 

From the outermost level, the number of nested ITERATED DATA 
BLOCKS is limited to 17; i.e., the number of levels of recursion is limited 
to 17. 

The address of each data byte must be within the frame specified by 
FRAME NUMBER. 



Hexadecimal Object File Format 

Hexadecimal object file format is a way of representing an object file in ASCII. 

The function of the utility program, 0H86, is tp convert 8086 absolute object 
modules to 8086 hexadecimal object modules. 
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The hexadecimal representation of binary is coded in ASCII. For example, the eight- 
bit binary value 0011 1111 is 3F in hexadecimal. To code this ASCII, one eight-bit 
byte containing the ASCII code for 3(00110011 or 33H) and one eight-bit byte con- 
taining the ASCII code for F(0I00 0110 or 46H) are required. This representation 
(ASCII hexadecimal) requires twice as many bytes as the binary. 

There are four different types of records that may make up an 8086 hexadecimal 
object file. They are: 

• Extended Address Record 

• Start Address Record 

• Data Record 

• End of File Record 

Each record begins with a RECORD MARK field containing 3AH, the ASCII code 
for colon (:). 

Each record has a REC LEN field which specifies the number of bytes of informa- 
tion or data which follows the RECTYP field of each record. Note that one byte is 
represented by two ASCII characters. 

Each record ends with a CHECKSUM field that contains the ASCII hexadecimal 
representation of the two's complement of the eight-bit sum of the eight-bit bytes 
that result from converting each pair of ASCII hexadecimal digits to one byte of 
binary, from and including the RECORD LENGTH field to and including the last 
byte of the DATA field. Therefore, the sum of all the ASCII pairs in a record after 
converting to binary, from the RECORD LENGTH field to and including the 
CHECKSUM field, is zero. 



Extended Address Record 



RECD 


REC 




REC 




CHK 


MARK 


LEN 


ZEROES 


TYP 


USBA 


SUM 




•02' 


'0000' 


'02' 







The 8086 EXTENDED ADDRESS RECORD is used to specify bits 4-19 of the Seg- 
ment Base Address (SBA) where bits 0-3 of the SBA are zero. Bits 4-19 of the SBA 
are referred to as the Upper Segment Base Address (USBA), The absolute memory 
address of a content byte in a subsequent DATA RECORD is obtained by adding 
the SBA to an offset calculated by adding the Load Address Field of the containing 
DATA RECORD to the index of the byte in the DATA RECORD (0, 1 , 2, ... n). 
The offset addition is done modulo 64K, ignoring a carry, so that offset wrap- 
around loading (from OFFFFH to OOOOOH) results in wrapping around from the end 
to the beginning of the 64K segment defined by the SBA. The address at which a par- 
ticular data byte is loaded is calculated as: 

SBA + ([DRLA + DRI] MOD 64K) 

where 

DRLA is the DATA RECORD LOAD ADDRESS. 
DRI is the data byte index within a DATA RECORD. 
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When an EXTENDED ADDRESS RECORD defines the value of SBA, the 
EXTENDED ADDRESS RECORD may appear anywhere within an 8086 hexa- 
decimal object file. This value remains in effect until another EXTENDED 
ADDRESS RECORD is encountered. The SBA defaults to zero until an 
EXTENDED ADDRESS RECORD is encountered. 

Reed Mark 

The RECD MARK field contains 03 AH, the hex encoding of ASCII ':'. 
Rec Len 

The Record Length field contains 3032H, the hex encoding of ASCII '02'. 
Zeroes 

The Load Address field contains 30303030H, the hex encoding of ASCII '0000'. 
Rec Typ 

The Record Type field contains 3032H, the hex encoding of ASCII '02'. 
USBA 

The USBA field contains four ASCII hexadecimal digits that specify the 8086 USBA 
value. The high-order digit is the 10th character of the record. The low order digit is 
the 13th character of the record. 

Chk Sum 

This is the check sum on the REC LEN, ZEROES, REC TYP, and USBA fields. 

Data Record 



RECD 


REC 


LOAD 


REC 




CHK 


MARK 


LEN 


ADDRESS 


TYP 


DATA 


SUM 








'00' 







The DATA RECORD provides a set of hexadecimal digits that represent the ASCII 
code for data bytes that make up a portion of an 8086 memory image. The method 
for calculating the absolute address for each byte of DATA is described in the 
discussion of the Extended Address Record. 



Reed Mark 

The RECD MARK field contains 03 AH, the hex encoding of ASCII ':'. 



Rec Len 

The REC LEN field contains two ASCII hexadecimal digits representing the number 
of data bytes in the record. The high-order digit comes first. The maximum value is 
'FF' or 4646H (255 decimal). 
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Load Address 

The LOAD ADDRESS field contains four ASCII hexadecimal digits representing 
the offset from the SBA (see EXTENDED ADDRESS RECORD) defining the 
address at which byte 0 of the DATA is to be placed. The LOAD ADDRESS value is 
used in calculation of the address of all DATA bytes. 

Rec Typ 

The REC TYP field in a DATA record contains 3O30H, the hex encoding of 
ASCII '00'. 

Data 

The DATA field contains a pair of hexadecimal digits that represent the ASCII code 
for each data byte. The high order digit is the first digit of each pair. 

Chk Sum 

This is the check sum on the REC LEN, LOAD ADDRESS, REC TYPE, and 
DATA fields. 



Start Address Record 



RECD 


REC 




REC 






CHK 


MARK 


LEN 


ZEROES 


TYP 


CS 


IP 


SUM 




'04' 


'0000' 


'03' 









The START ADDRESS RECORD is used to specify the execution start address for 
the object file. Values are given for both the Instruction Pointer (IP) and Code Seg- 
ment (CS) registers. This record can appear anywhere in a hexadecimal object file. 

If a START ADDRESS RECORD is not present in an 8086 hexadecimal file, a 
loader is free to assign a default start address. 

Reed Mark 

The RECD MARK field contains 03AH, the hex encoding for ASCII 
Rec Len 

The REC LEN field contains 3034H, the hex encoding for ASCII '04'. 
Zeroes 

The ZEROES field contains 30303030H, the hex encoding for ASCII '0000'. 
Rec Typ 

The REC TYP field contains 3033H, the hex encoding for ASCII '03'. 
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CS 

The CS field contains four ASCII hexadecimal digits that specify the 8086 CS value. 
The high-order digit is the 10th character of the record; the low-order digit is the 
1 3th character of the record. 



IP 

The IP field contains the four ASCII hexadecimal digits that specify the 8086 IP 
value. The high-order digit is the 14th character of the record, the low order digit is 
the 17th character of the record. 

Chk Sum 

This is the check sum on the REC LEN, ZEROES, REC TYP, CS, and IP fields. 



End of File Record 



RECD 


REC 




REC 


CHK 


MARK 


LEN 


ZEROES 


TYP 


SUM 




'00' 


'0000' 


'01 ' 


'FF' 



The END OF FILE RECORD specifies the end of the hexadecimal object file. 
Reed Mark 

The RECD MARK field contains 03AH, the ASCII code for colon (:). 
Rec Len 

The REC LEN field contains two ASCII zeroes (3030H). 
Zeroes 

The ZEROES field contains four ASCII zeroes (30303030H). 
Rec Typ 

The REC TYP field contains 3031H, the ASCII code for OIH. 
Chk Sum 

The CHK SUM field contains 4646H, the ASCII code for FFH, which is the cheek 
sum on the REC LEN, ZEROES and REC TYP fields. 
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Examples 

Sample Absolute Object File 

The following is an example of an absolute object file. The file contains eight 
records. The eight records perform the following functions: 

Record Function 

1 LHEADR record begins the object module and defines the module 
name. 

2 THE ADR record defines the translator-generated module name 
which is the same as the name in the LHEADR record. 

3 PEDATA record defines a contiguous memory image from 00200H 
to00215H. 

4 PEDATA record defines a contiguous memory image from 00360H 
to00377H. 

5 PEDATA record defines a contiguous memory image from 00415H 
to0042BH. 

6 PEDATA record defines a contiguous memory image from 
051620H to051633H. 

7 PIDATA record defines a contiguous memory image from 
051 BOOH to 051B1DH. The iterated data consists of three repeti- 
tions of "ABC" (414243H), followed by three repetitions of (four 
repetitions of "D" (44H)), three repetitions of "E" (45H). 

8 MODEND record specifies that the module should be started with 
CS = 5162H and IP = 0005H. 



(1) 82 0008 0653414D504C45 AE 

(2) 80 0008 0653414D504C45 BO 

(3) 84 001 A 0020 00 
004992DB246DB6FF4891DA236CB5FE47 
90D9226BB4FD 63 

(4) 84 OOlC 0036 00 
0062C42688EA4CAE1072D43698FA5CBE 
2082E446A80A6CCE 82 

(5) 84 00 IB 0041 05 
001D3A577491AECBE805223F5C7996B3 
D0ED0A2744617E 72 

(6) 84 0018 5162 00 

00850 ASF 1 499 1 E A328 AD32B73 CC 1 46CB 
50D55ADF FB 

(7) 86 OOlC 51B0 00 
0003 0000 03 414243 

0003 0002 

0004 0000 01 44 
0003 0000 01 45 FA 

(8) 8 A 0006 CO 5162 0005 F8 

NOTE 

The blank characters and carriage return and line feed characters are 
inserted here to improve readability. They do not occur in an object 
module. This file has been converted to ASCII hex so that it may be printed 
here. All word values (RECORD LENGTH, REPEAT COUNT, etc.) have 
been byte-reversed to improve readability. 
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Sample Absolute Hexadecimal Object File 



The following is the hexadecimal object file representation of the object file given in 
the example above: 



:020000020020DC 

: 10000000004992DB246DB6FF489 1 D A236CB5FE47B8 

:0600 100090D9226BB4FD43 

:020000020036C6 

:10O0O0000O62C42688EA4CAE1072D43698FA5CBEO0 

:080010002082E446A80A6CCE30 

:020000020041BB 

:10O0O5OOOOlD3A577491AECBE8O5223F5C7996B353 

:07001500DOEDOA2744617ED3 

:020000025 1 6249 

:1000000000850A8F14991EA328AD32B73CC146CB98 

:0400 100050D55 ADF8E 

:0200000251B0FB 

: 1 00000004 1 42434 1 42434 1424344444444454545 BF 
:0E001000444444444545454444444445454524 
:040000035 162000541 
:00000001FF 
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HEXADECIMAL-DECIMAL CONVERSION 



The following table is for hexadecimal-to-decimal and decimal-to-hexadecimal con- 
version. To find the decimal equivalent of a hexadecimal number, locate the hexa- 
decimal number in the correct position and note the decimal equivalent. Add the 
decimal numbers. 

To find the hexadecimal equivalent of a decimal number, locate the next lower 
decimal number in the table and note the hexadecimal number and its position. Sub- 
tract the decimal number from the table from the starting number. Find the dif- 
ference in the table. Continue this process until there is no difference. 



BYTE 


BYTE 


BYTE 


HEX 


DEC 


HEX 


DEC 


HEX 


DEC 


HEX 


DEC 


HEX DEC 


HEX DEC 


0 


a 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


1 


1,048,576 


1 


65,536 


1 


4,096 


1 


256 


1 


16 


1 


1 


2 


2,097,152 


2 


131,072 


2 


8,192 


2 


512 


2 


32 


2 


2 


3 


3,145,728 


3 


196,608 


3 


12,288 


3 


768 


3 


48 


3 


3 


4 


4,194,304 


4 


262,144 


4 


16,384 


4 


1,024 


4 


64 


4 


4 


5 


5,242,880 


5 


327,680 


5 


20,480 


5 


1,280 


5 


80 


5 


5 


6 


6,291,456 


6 


393,216 


6 


24,576 


6 


1,536 


6 


96 


6 


6 


7 


7,340,032 


7 


458,752 


7 


28,672 


7 


1,792 


7 


112 


7 


7 


8 


8,388,608 


8 


524,288 


8 


32,768 


8 


2,048 


8 


128 


8 


8 


9 


9,437,184 


9 


589,824 


9 


36,864 


9 


2,304 


9 


144 


9 


9 


A 


10,485,760 


A 


655,360 


A 


40,960 


A 


2,560 


A 


160 


A 


10 


B 


11,534,336 


B 


720,896 


B 


45,056 


B 


2,816 


B 


176 


B 


11 


C 


12,582,912 


C 


786,432 


C 


49,152 


C 


3,072 


C 


192 


C 


12 


D 


13,631,488 


D 


851,968 


D 


53,248 


D 


3,328 


D 


208 


D 


13 


E 


14,680,064 


E 


917,504 


E 


57,344 


E 


3,584 


E 


224 


E 


14 


F 


15,728,640 


F 


983,040 


F 


61,440 


F 


3,840 


F 


240 


F 


15 
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APPENDIX C 
THE EFFECT OF AVAILABLE MEMORY 
ON LINK86, CREF86. LIB86, AND LOC86 



The system resources required by LINK86, CREF86, LIB86, or LOC86 depend on 
the number of symbols, modules, or segments in the input file(s). The greater the 
number of symbols in the input, the greater the memory requirements. 



These utilities can take advantage of up to 512K of available memory space. When 
the number of symbols in the input list requires more memory than is available, 
these utilities use disk resources to accommodate the remainder. Available memory 
means RAM which the utilities have available to them exclusively. Once a utility has 
run out of memory and has to use disk, performance will become impaired. 

The following table defines the number of symbols or modules which these utilities 
may process without performance degradation, given several levels of available 
memory. The available memory depends on the hardware and software environment 
under which the utilities are running on your system. Note that the relationship 
between number of symbols or modules and the amount of available memory is 
linear, up to a maximum. The following assumptions were used to calculate the 
figures provided: 

• Variable and module names average 10 characters. 

• Each symbol has five references (CREF86). 

• Each module has 1 .4 public names (LIB86). 

• A symbol as used here is an abstract representation of an 8086 object module 
format record: 



LINK86, CREF86, AND LIB86 



LINK86 



CREF86 



LIB86 



Maximum number of symbols or 
modules which can be processed 
without performance penalty: 



With 100K available memory 
With 164K available memory 
With 228K available memory 
With 484K available memory 



1,700 symbols 
2,900 symbols 
4,200 symbols 
10,000 symbols 



1,900 symbols 
3,300 symbols 
4,700 symbols 
11,000 symbols 



450 modules 



1,000 modules 
1,700 modules 
4,000 modules 



Theoretical maximum number of 
symbols or modules, regardless of 
available memory: 



10,000 symbols 



11,000 symbols 



4,000 symbols 



L0C86 



With 96K of available memory, LOC86 will support up to 900 segments. 
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APPENDIX D 
LINK86 CONTROLS 
AND ERROR MESSAGES 



Table D-1 lists all of LINK86's control syntax, abbreviations, and default settings. 



Table D-1 . Summary of LINK86 Controls 



Control 


Abbrev. 


Default 


kSS\GH(ivariable(address)y[,...]) 


AS 


Not applicable 


kSS\JMER001 {pathname) 


AR 


Not applicable 


BIND 


Bl 


NOBIND 


NOBIND 


NOB! 


COMMENTS 


CM 


COMMENTS 


NOCOMMENTS 


NOCM 


FASTLOAD 


FL 


NOFASTLOAD 


NOFASTLOAD 


NOFL 


INITCODE 


IC 


Not applicable 


LINES 


LI 


LINES 


NOLINES 


NOLI 


MAP 


MA 


MAP 


NOMAP 


NOMA 


MEMPOOL(m in-size[,maxsize]) 


MP 


Not applicable 


UAME(module name) 


NA 


Not applicable 


OBJECTCONTROLS{ 

{LINES 1 NOLINES | 
COMMENTS 1 NOCOMMENTS | 
SYMBOLS 1 NOSYMBOLS | 
PUBLICS [EXCEPT(sym6o/ [,...])] I 
NOPUBLICS [EXCEPT(sym/)o/ [,...])] I 
TYPE 1 NOTYPE | 
PURGE 1 NOPURGE> [,...]) 


OC 


Not applicable 


ORDER(igroup(isegment[\class[\ overlay ]]} 
l,..))> 

[.-]) 


OD 


Not applicable 


OVERLAYMoi^er/ay)] 


OV 


NOOVERLAY 


NOOVERLAY 


NOOV 


Pn\tiJ[{pathname)] 


PR 


PRINT(o6yecf ff/e.MP1) 


NOPRINT 


NOPR 


PRINTCONTROLS( 

-CLINES 1 NOLINES | 
COMMENTS 1 NOCOMMENTS | 
SYMBOLS 1 NOSYMBOLS | 
PUBLICS [EXCEPT(sy/7)f)o/ [,...])] | 
NOPUBLICS [EXCEPT(sy/T76o/ [,...])] | 
TYPE 1 NOTYPE | 
PURGE 1 NOPURGE> [,...]) 


PC 


Not applicable 
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Table D-1 . Summary of LINK86 Controls (Cont'd.) 



Control 


Abbrev. 


Default 


PUBLICS [EXCEPJ(symbol [,...])] 


PL [EC] 


PUBLICS 


NOPUBLICS [EXCEPT(symbol [,...])] 


NOPL [EC] 




PUBLICSONLY(pa//jna/ne[,...]) 


PO 


Not applicable 


PURGE 


PU 


NOPURGE 


NOPURGE 


NOPU 


NOPURGE 


RENAMEGROUPS( {group TOgroupy [,...]) 


RG 


Not applicable 


SEGSIZE( 

{ segment[ \ class [ \ overlay]] 
(min-size[,[fnax- size]])y 
[....]) 


SS 


Not applicable 


SYMBOLS 


SB 


SYMBOLS 


NOSYMBOLS 


NOSB 




SYMB0LC0LUIVINS({1 1 2 1 3 1 4>) 


SC 


SYMBOLCOLUMNS(2) 


TYPE 


TY 


TYPE 


NOTYPE 


NOTY 





The following are descriptions of all LINK86 error and warning messages. The 
description of each message has up to four parts: , 

• Meaning — how to interpret the message 

• Cause — the usual reason for the error or warning condition 

• Effect— the state of LINK86 and the object file(s) after the message is issued 

• User Action — what you can do to correct the condition 

Not all these parts are given for each message. However, parts excluded are self- 
explanatory. 

Error messages are always fatal, but warning messages are not. In the event of a 
warning, read the EFFECT of the warning carefully to determine whether the 
resulting code is valid. 



Error and warning messages are displayed at the console device, but printed only if a 
listing would otherwise be printed. 



ERROR 1 : I/O ERROR 

operating system error message 
FILE: pathname 



ERROR 2: I/O ERROR 

operating system error message 
FILE: pattiname 
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ERROR 3: I/O ERROR 

operating system error message 
FILE: pathname 

ERROR 4: CONSOLE I/O ERROR 
operating system error message 
FILE: pathname 

Meaning 

An I/O error was detected by the operating system. The error number identifies the 
file that caused the error: 

1 . The input file 

2. The print file 

3. The object file 

4. The console file (usually the console) 

Refer to the documentation for your operating system for a complete list of all 
possible messages. 

Effect 

LINK 86 immediately terminates processing, all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Correct the error and restart LINK86. 

ERROR 5: INPUT PHASE ERROR 
FILE: pathname 
MODULE: module name 

Meaning 

LINK86 encountered a record during the second phase of linkage that does not agree 
with information gathered during the first phase of linkage. 

Cause 

This error is caused by a data transmission error or a LINK86 error. 
Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Contact Intel immediately. Forward a copy of the object file, the LINK86 invoca- 
tion line, and your version of LINK86. 
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ERROR 6: CHECK SUM ERROR 
FILE: pathname 
MODULE: module name 

Meaning 

The check sum field at the end of one of the object module records indicates a 
transcription error. 

Cause 

Any one of many possible data encoding or communication errors could be at fault. 
Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Retranslate the source that produced the specified module and relink. 



ERROR 7: COMMAND INPUT ERROR 
Meaning 

LINK86 encountered an error while attempting to read the complete invocation line. 
Cause 

Possibly an end-of-file while reading from the console input device. 
Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Examine the invocation line, and reinvoke LINK86 correctly. 
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WARNING 8: SEGMENT COMBINATION ERROR 
FILE: pathname 
MODULE: module name 
SEGMENT: segment name 
CLASS: class name 

Meaning 

Two segments with the same name have been found to be uncombinable. 
Cause 

The specified segments have different combination attributes or incompatible align- 
ment attributes. 

Effect 

Although LINK86 will continue processing pass 1 , pass 2 will not be started. The 
object file will be useless and the print file will contain limited information. 

User Action 

Retranslate the source that produced the specified file and module. 



WARNING 9: TYPE MISMATCH 
FILE: pathname 
MODULE: module name 
SYMBOL: symbol name 

Meaning 

LINK86 has found a public/external symbol pair for which the type definitions do 
not agree. 

Effect 

LINK86 continues processing using the first definition only. The object file and the 
print file should be valid, except the second definition is ignored. 

User Action 

Modify the public or external declaration and recompile and relink the source file. 
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WARNING 10: DIFFERENT VALUES FOR 
FILE: pathname 
MODULE: module name 
SYMBOL: symbol name 

Meaning 

LINK86 encountered the same symbol declared public in two different modules. The 
specified file and module contains the second definition encountered. 

Cause 

Two modules have used the same symbol name for different public definitions. 
Effect 

LINK86 continues processing using the value of the first public definition; the 
second definition is ignored. Both the print file and the object file will be valid. 

User Action 

Change the name of the symbol in either the specified file or the file containing the 
earlier definition. 



ERROR 11: INSUFFICIENT MEMORY 
FILE: pathname 
MODULE: module name 

Meaning 

There is insufficient memory in your system for LINK86 to build its internal tables 
and data structures. 

Cause 

You are using too many public symbols. 
Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

If expanding system memory is not possible, try incremental linkage (i.e., link 
smaller sets of files together using the NOPUBLICS control, then link the resulting 
composite modules together). 
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WARNING 12: UNRESOLVED SYMBOLS 
FILE: pathname 
MODULE: module name 

Meaning 

There are declarations of external symbols that were not resolved during this 
linkage. 

Cause 

This is very common when performing an incremental linkage. 
Effect 

The print file is valid. The object file must be linked to resolve the external 
references. 

User Action 

Link object file to a file that will resolve the external references. 



WARNING 13: IMPROPER FIXUP 
FILE: pathname 
MODULE: module name 

Cause 

The external reference makes assumptions about the segment register that do not 
agree with the assumption made for the public definition. 

Effect 

LINK86 continues processing. The object file will not be usable, but the print file 
will be complete and accurate. 

User Action 

Depending on the cause of the error: change your ORDER control, recompile with a 
different model of segmentation, or change the source and reassemble. 
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WARNING U: GROUP ENLARGED 
FILE: pathname 
GROUP: group name 
MODULE: module name 

Meaning 

The specified group name has been defined twice in two different modules. The 
segments contained in the two definitions are different. 

Effect 

The two groups are combined into one. All segments that were in either group are 
included in the resulting group. Segments with the same segment name, class name, 
and overlay name are combined. LINK86 continues processing. Both the print file 
and object file are valid. 

User Action 

No user action should be necessary. 



ERROR 15: LINK86 ERROR 
FILE: pathname 
MODULE: module name 

User Action 

Contact Intel immediately. Forward a copy of the object file, the LINK86 invoca- 
tion line, and your version of LINK86. 



ERROR 16: STACK OVERFLOW 
FILE: pathname 
MODULE: module name 

Meaning 

LINK86's run time stack used for type matching has overflowed. 
Cause 

The type definition of one of your symbols is overly complex. 
Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Try incremental linkage — if error persists, contact Intel. 
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WARNING 17: SEGMENT OVERFLOW 
SEGMENT: segment name 
CLASS: class name 

Meaning 

The combination of two or more segments has resulted in a segment that exceeds 
64K. 

Effect 

LINK86 continues processing during the current pass, but the print and object files 

are not useable. 

User Action 

Reorganize your segments and reassemble. 



WARNING 18: IMPROPER START ADDRESS 
FILE: pathname 
MODULE: module name 

Meaning 

A start address was found in one of the overlay modules, and none was found in the 
root module. 

Cause 

This error is often caused by misordering the input modules in the input Hst. 
Effect 

LINK86 ignores the start address in the specified overlay module and continues 
processing. 

User Action 

If you want the module containing the start address to be the root, relink with that 
module first in the input list. 



ERROR 19: TYPE DESCRIPTION TOO LONG 
FILE: pathname 
MODULE: module name 

Meaning 

The type definition is too long to fit in LINK86's symbol table. 
Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Contact Intel immediately. Forward a copy of the object file, the LINK86 invoca- 
tion line, and your version of LINK86. 
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WARNING 20: NO SUCH GROUP 
NAME: group name 

Cause 

You have attempted to rename a nonexistent group. 
Effect 

LINK86 ignores the RENAME control and continues processing. 
User Action 

Reinvoke LINK86 with the correct invocation line. 

WARNING 21 : RENAME ERROR 
NAME: name 

Meaning 

The new group name specified is the same as an existing group. 
Effect 

The group is not renamed. LINK86 continues as if the rename control was not given. 
User Action 

Reinvoke LINK86 with the correct invocation line. 

ERROR 22: INVALID SYNTAX 

ERROR IN COMMAND TAIL NEAR # 

partial command tail 

Cause 

This is usually the result of a typo in the invocation line. The partial command tail 
up to the point where the error was detected is printed. 

Effect 

LINK86 terminates processing and closes all open files. The contents of the print file 
and the object file are undefined. 

User Action 

Reinvoke LINK86 more carefully this time. 
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ERROR 23: BAD OBJECT FILE 
FILE: pathname 
MODULE: module name 

Meaning 

LINK86 has discovered an inconsistency in the fields of a record in the specified 
input file. 

Cause 

This could be an error by the translator or a data transmission error. 
Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Retranslate the source file. If the problem persists contact Intel. 

WARNING 24: CANNOT FIND MODULE 
FILE: pathname 
MODULE: module name 

Meaning 

The specified module cannot be found in the specified library file. 
Effect 

LINK86 continues processing as if the specified module was not in the list. 
User Action 

If the module is important, you can link it into the output object file later. 

WARNING 25: EXTRA START ADDRESS IGNORED 
FILE: pathname 
MODULE: module name 

Meaning 

LINK86 has encountered a start address in more than one module. 
Cause 

This will occur any time you specify more than one main module in the input list. 
Effect 

LINK86 uses the start address encountered earlier and ignores the start address in 
the specified module. LINK86 continues processing with no other side effects. 

User Action 

None, if the start address in the specified module was intended to be ignored. 
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ERROR 26: NOT AN OBJECT FILE 
FILE: pathname 

Meaning 

The specified file is not an object file. 
Cause 

This is usually the result of a typo when entering. However, certain data trans- 
mission errors can also cause this error. 

Effect 

LINK86 terminates processing and closes all open files. 
User Action 

Reinvoke LINK86 typing the line more carefully. If error resulted from a data 
transmission error, retranslate and then relink. 



ERROR 27: OPERATING SYSTEM INTERFACE ERROR 
FILE: pathname 

Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Refer to the documentation for your operating system. If you cannot correct the 
error condition, contact Intel; forward a copy of the object file, the LINK86 invoca- 
tion line, and your version of LINK86. 



WARNING 28: POSSIBLE OVERLAP 
FILE: pathname 
MODULE: module name 
SEGMENT: segment name 
CLASS: class name 

Meaning 

LINK86 issues this warning when it combines two absolute segments. 
Effect 

LINK86 continues processing with no side effects. 
User Action 

If there is a conflict LOC86 or the loader will detect the overlap. 
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WARNING 29: GROUP HAS BAD EXTERNAL REFERENCE 
GROUP: group name 
SEGMENT: segment name 

Meaning 

This error occurs if the public symbol corresponding to an external reference has 
been specified by its absolute address, and the address does not reside in any 
segment. 

Effect 

L1NK86 continues processing and the print and object files will be valid except the 
external reference has not been properly resolved. 

User Action 

Either remove the reference to the public symbol or do not allow the symbol to be 
absolute. 



ERROR 30: LIBRARY IS NOT ALLOWED WITH PUBLICSONLY CONTROL 
FILE: pathname 

Meaning 

The specified file is a library and libraries are not allowed in a PUBLICSONLY 
control. 

Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Remove library file from PUBLICSONLY argument list and reinvoke LINK86. 



WARNING 31: REFERENCED LOCATION OFFSET UNDERFLOW 

FILE: pathname 
MODULE: module name 

Meaning 

While computing the offset for an 8089 self relative reference, LINK86 had a 
negative result. 

Cause 

Either with the ORDER control or the order of files in the input list, the reference 
was separated from its target, or the 8089 segment is too large. 

Effect 

LINK86 continues processing; however, the invalid offset computation is used. 
User Action 

Examine the ORDER control in the invocation line and modify its arguments. 
Reinvoke LINK86 carefully. 
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WARNING 32: EXTRA REGISTER INITIALIZATION RECORD IGNORED 
FILE: pathname 
MODULE: module name 

Cause 

You have included two main modules in your input list. 
Effect 

LINK86 uses the first register initialization record and ignores the second. Process- 
ing continues. 

User Action 

If the register initialization information in the specified file and module should be 
used, then modify your input list; otherwise, no user action is necessary. 

ERROR 33: ILLEGAL USE OF OVERLAY CONTROL 
FILE: pathname 
MODULE: module name 

Meaning 

LINK86 has found an overlay definition in the specifed file and module, while pro- 
cessing input modules for an overlay. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Remove the specified file from the input list and relink. 

ERROR 34: TOO MANY OVERLAYS IN INPUT FILE 
FILE: pathname 
MODULE: module name 

Meaning 

The specified file and module above contains more than one overlay definition. 
Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Remove the specified file from the input list and relink. 
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ERROR 35: SAME OVERLAY NAME IN TWO OVERLAYS 
FILE: pathname 
MODULE: module name 
NAME: name 

Meaning 

The specified file contains an overlay that has the same name as an overlay 
encountered in the input list. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Remove one of the duplicate names from the input list and relink. If both overlays 
are necessary, relink one overlay specifying a different overlay name. 



ERROR 36: ILLEGAL OVERLAY CONSTRUCTION 
FILE: pathname 
MODULE: module name 

Meaning 

Some of the modules in the input list contain overlay definitions while others do not. 
This is not permitted — all modules in the input list must be the same with respect to 
overlays. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Remove the non-overlay files and relink. 



WARNING 37: DIFFERENT PUBLICS FOR EXTERNAL IN ROOT 
FILE: pathname 
MODULE: module name 

Meaning 

LINK86 has found two symbol definitions in the overlay modules that resolve an 
external symbol definition in the root. 

Effect 

LINK86 ignores the definition in the specified file and module, and continues pro- 
cessing with no side effects. 

User Action 

Remove the unwanted symbol definition and relink. 
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ERROR 38: INVALID OVERLAPPING GROUPS 
FILE: pathname 
MODULE: module name 
SEGMENT: segment name 
GROUP: group name 

Meaning 

While binding the input list LINK86 found a segment that was defined to be within 
two groups. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Either modify the source to remove the segment from one of the groups or do not 
link with the BIND control. 

ERROR 39: SPECIFIED GROUP NOT FOUND IN INPUT MODULE 
GROUP: group name 

Cause 

Often this is the result of a typographical error in the invocation line. 
Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Correct the invocation line and relink. 

ERROR 40: SPECIFIED SEGMENT NOT FOUND IN THE GROUP 
SEGMENT: segment name 
GROUP: group name 

Cause 

Usually this is the result of a typographical error in the ORDER control. 
Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Correct the invocation line and relink. 
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ERROR 41: SPECIFIED SEGMENT NOT FOUND IN INPUT MODULE 
SEGMENT: segment name 
CLASS: class name 

Cause 

Usually this is the result of a typographical in the SEGSIZE control. 
Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Find the module that contains the specified segment and add it to the input list. 

WARNING 42: DECREASING SIZE OF SEGMENT 
SEGMENT: segment name 

Meaning 

The size change specified in SEGSIZE has caused LINK86 to decrease the size of the 
specified segment. 

Effect 

Decreasing the size of a segment can cause sections of code to be unaccounted for 
during the memory allocation process. LINK86 continues processing with no side 
effects. 

User Action 

None if the size decrease was intended. 

ERROR 43: SEGMENT SIZE OVERFLOW; OLD SIZE + CHANGE > 64K 
SEGMENT: segment name 
CLASS: class name 

Meaning 

The size change specified in the SEGSIZE control caused the segment to become 
greater than 64K. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Reinvoke LINK86 with the correct SEGSIZE control. 
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ERROR 44: SEGMENT SIZE UNDERFLOW; OLD SIZE + CHANGE < 0 
SEGMENT: segment name 
CLASS: class name 

Meaning 

The size change specified in the SEGSIZE control caused the segment's size to be 
less than zero. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Reinvoke LINK86 with the correct SEGSIZE control. 

ERROR 45: THE SEGMENT MAXIMUM SIZE IS LESS THAN THE 
SEGMENT MINIMUM SIZE 
SEGMENT: segment name 
CLASS: class name 

Cause 

Usually this is the result of a typographical error in the SEGSIZE control. 
Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Correct the invocation line and relink. 

ERROR 46: ILLEGAL USE OF SEGSIZE CONTROL 
SEGMENT: segment name 
CLASS: class name 

Cause 

A maximum size was specified for either a stack segment, an absolute segment, or a 
segment that is not the highest component of its group. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Remove the specified segment from the SEGSIZE control and relink. 
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WARNING 47: GROUP HAS NO CONSTITUENT SEGMENTS 
GROUP: group name 

Meaning 

The group has no segments and is not placed in the output object file. 
Cause 

Often this is the result of a typographical error in the invocation line. 
Effect 

LINK86 does not place the specified group in the object file and continues process- 
ing with no side effects. 

User Action 

Unless there is some particular need for the specified group, no user action is 
necessary. 



WARNING 48: SIZE OF GROUP EXCEEDS 64K 
GROUP: group name 

Meaning 

All of the segments that belong to the specified group do not fit within the physical 
segment defined for that group. 

Cause 

This error is usually caused by misuse of the SEGSIZE or ORDER controls. 
Effect 

LINK86 includes all segments in the object file and continues processing the input 
module. The output module will be executable, although addressing errors may 
occur. 

User Action 

Examine the invocation line and reinvoke LINK86 using the SEGSIZE or ORDER 
control more carefully. 



D-19 



LINK86 Controls and Error Messages 



iAPX 86,88 Family Utilities 



WARNING 49: MAXIMUM SIZE OF GROUP EXCEEDS 64K 
GROUP: group name 

Meaning 

The maximum segment size for the segments contained in the specified group 
exceeds 64K. 

Cause 

This error is usually caused by misuse of the SEGSIZE control. 
Effect 

LINK86 reduces the maximum size of the group and its constituent segments. 
LINK86 continues processing the input module. The output module will be 
executable. 

User Action 

No action is necessary. If you want to remove the error, examine the invocation line 
and reinvoke LINK86 using the SEGSIZE control more carefully. 



WARNING 50: MORE THAN ONE SEGMENT WITH THE MEMORY 
ATTRIBUTE 
SEGMENT: segment name 

Meaning 

After the first memory segment is found, LINK86 issues this warning each time it 
finds a segment with the memory attribute. 

Effect 

LINK86 ignores the memory attribute on the segment specified in the message. 
Processing continues with LINK86 treating the additional memory segment as just 
another segment. 

User Action 

Depending on your intentions, this message may be ignored or you may wish to 
change the segment definition and relink. 



WARNING 51: SEGMENT WITH MEMORY ATTRIBUTE NOT PLACED 
HIGHEST IN MEMORY 
SEGMENT: segment name 

Meaning 

The specified memory segment was not located at the highest offset in its group. 
Cause 

This can only occur when you explicitly request this organization through the 
ORDER control. 

Effect 

Since this can only occur by user request, LINK86 continues processing without side 
effects. 
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WARNING 52: OFFSET FIXUP OVERFLOW 
FILE: pathname 
MODULE: module name 

Meaning 

While computing an offset from a base, LINK86 found that the offset was greater 
than 64K. 

Cause 

One of the segments of a group is outside the 64K frame of reference defined by its 
group base. 

Effect 

LINK86 continues processing. The print file will be valid, but the output file with 
regard to the out of place segment will not be usable. 

User Action 

Modify the group definitions in your source and retranslate. 

WARNING 53: OVERFLOW OF LOW BYTE FIXUP VALUE 
FILE: pathname 
MODULE: module name 

Meaning 

An 8-bit displacement value, when calculated, exceeded 255. 
Cause 

This type of error often occurs when a page resident segment crosses a page 
boundary. 

Effect 

LINK86 continues processing. The contents of both the print file and the object file 
will be valid. However, the fixup value will remain invalid. 

User Action 

Organize your segments so that the addressing error will not be encountered. 

ERROR 54: ILLEGAL USE OF ORDER CONTROL 
GROUP: group name 

Meaning 

The specified group's segments have already been ordered. 
Cause 

You are attempting to relink a file that has been linked with the BIND control. 
Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Relink using the unbound input modules. 
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ERROR 55: ILLEGAL FIXUP 
FILE: pathname 
MODULE: module name 

Meaning 

While processing a fixup record, LINK86 found that the base for the reference and 
target are different. 

Cause 

This is usually a coding error. 
Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Examine your assembly language source and retranslate. 

ERROR 56: DATA ADDRESS OUTSIDE SEGMENT BOUNDARIES 
FILE: pathname 
MODULE: module name 
SEGMENT: segment name 

Meaning 

One of the data records associated with the specified segment contains an address 
outside of the segment's boundary. 

Cause 

This error can occur when you decrease the size of a segment. 
Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Change SEGSIZE control and relink. 

ERROR 57: MAXIMUM DYNAMIC STORAGE LESS THAN MINIMUM 
DYNAMIC STORAGE 

Meaning 

The size change specified in MEMPOOL has caused the maximum dynamic storage 
to be less than the minimum dynamic storage. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Reinvoke LINK86 with correct arguments to MEMPOOL. 
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WARNING 58: NO START ADDRESS SPECIFIED IN INPUT MODULES 
Meaning 

The BIND control was specified, and none of the input modules has a start address. 
Cause 

The input list contains no main module. 
Effect 

The CS and IP registers remain uninitialized, and their values are dependent on your 
system loader. The object module will be valid. 

User Action 

Reinvoke LINK86 with a main module or execute LOC86 with the START control. 

ERROR 59: I/O ERROR WITH ROOT-FILE IN ASSUMEROOT CONTROL 
FILE: pathname 
operating system message 

Meaning 

The ASSUMEROOT control was specified, but the root file identified by pathname 
in the invocation could not be accessed. 

Effect 

LINK86 immediately terminates processing. 
User Action 

Refer to your operating system documentation to correct the condition, then rein- 
voke LINK86. 

ERROR 60: OUTPUT FILE IS SAME AS INPUT FILE 
FILE: pathname 

Meaning 

LINK86 detected an output pathname identical to an input pathname. 
Cause 

The pathnames of the specified input file and the output file were identical. 
Effect 

LINK86 terminates processing immediately. 
User Action 

Reinvoke LINK86 after fixing the duplicate-name situation. 
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ERROR 61: ROOT-FILE IN ASSUMEROOT CONTROL IS NOT PROPER 
OBJECT FILE 
FILE: pathname 

Meaning 

The ASSUMEROOT control was specified, but the root file is not found to have an 
overlay record in it. 

Cause 

The root file needs an overlay record. 
Effect 

LINK86 terminates processing immediately. 
User Action 

Relink the root file using the OVERLAY control. 

WARNING 62: ASSUMEROOT CONTROL MEANINGFUL ONLY WITH 
OVERLAYS 

Meaning 

The ASSUMEROOT control should be used only when the input modules do not 

contain overlay records. 

Cause 

ASSUMEROOT was specified, but not in conjunction with the OVERLAY control. 
Effect 

LINK86 ignores the ASSUMEROOT control. The object code is valid. 
User Action 

Reinvoke LINK86, using the OVERLAY and ASSUMEROOT controls. 

WARNING 63: BAD SEGMENT ALIGNMENT 

FILE: pathname 
MODULE: module name 
SEGMENT: segment name 

Meaning 

The segment is not paragraph/page-aligned. 
Cause 

The object code has references to the base of the specified segment, and the segment 
is not declared as paragraph/page-aligned. 

Effect 

Although the object module will be valid, the loader may not load the program 
correctly. 

User Action 

Declare the specified segment to be paragraph/page-aligned. 
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WARNING 64: PUBLIC SYMBOLS NOT SORTED DUE TO INSUFFICIENT 
MEMORY 

Meaning 

The amount of memory required to sort the public symbols for the LINK86 print file 
listing is insufficient. 

Cause 

The number of public symbols in the input-list modules is too large for LINK86 to 
sort with the available memory resources. 

Effect 

The LINK86 print file listing provides public symbols in the order in which they were 
encountered in the input files. This condition has no effect on the correctness or 
validity of the output module. 

User Action 

Increase the amount of available RAM or decrease the number of public symbols. 



WARNING 65: ILLEGAL FIXUP: INCORRECT DECLARATION OF 
EXTERNAL SYMBOL 
FILE: pathname containing external declaration 
MODULE: name of module containing external declaration 
SYMBOL: name of external symbol 
FRAME: identification of reference location 
TARGET: identification of target location 

Meaning 

The declaration of the specified SYMBOL was found to be inconsistent with a 
corresponding public symbol definition, and LINK86 could not resolve the 
reference. 

Cause 

This condition may exist for several reasons. The modules containing the external 
and public symbols may have been compiled under different translator controls 
(e.g., SMALL, LARGE). In the case of assembly language programs, the SYMBOL 
may be defined in a group, segment, or frame different from that in which it is 
declared as external. Or an attempt has been made to access absolute entry points 
from pre-located code without using the PUBLICSONLY control explicitly. 

Effect 

LINK86 internally converts these illegal fixups to legal formats to identify all 
occurrences in a single execution. Thus the output object module may not be cor- 
rect, although it will be a valid 8086 object module. 

User Action 

If the warning occurred because of an attempted access of absolute entry points 
from pre-located code, use the PUBLICSONLY control in conjunction with the file 
that contains public definitions for those entry points. Otherwise, use the FRAME 
and TARGET information given in the warning message to pinpoint the source of 
the error, then correct the code. 
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For example: 

WARNING 65: ILLEGAL FIXUP: INCORRECT DECLARATION OF 
EXTERNAL SYMBOL 
FILE: EXTFIL 
MODULE: EXTMODULE 
SYMBOL: EXTSYM 
FRAME: GROUP - GR0UP1 
TARGET: SEGMENT - SEGMENTS 

The symbol EXTSYM is declared to be in SEGMENTS. The external-public resolu- 
tion specified that the calculations be made with respect to the base of GROUP 1, 
but the segment SEGMENTS is not in GROUP 1 . 



WARNING 66: CS AND IP REGISTERS ARE NOT INITIALIZED 
Meaning 

The INITCODE control was specified, and the register initialization record does not 
contain information for initialization of 8086 registers. CS means code segment 
register, and IP means instruction pointer. 

Cause 

This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 

Effect 

The values of CS and IP at the beginning of program execution are entirely depen- 
dent on the loader of your system. The object code will be valid. 

User Action 

Retranslate your code, then reinvoke LINK86. 



WARNING 67: SS AND SP REGISTERS ARE NOT INITIALIZED 
Meaning 

The INITCODE control was specified, and the register initialization record does not 
contain information for initialization of 8086 registers. SS means stack segment and 
SP means stack pointer. 

Cause 

This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 

Effect 

The values of SS and SP at the beginning of program execution are entirely depen- 
dent on the loader of your system. The object code will be vahd. 

User Action 

Correct your code if necessary, then reinvoke LINK86. 
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WARNING 68: DS REGISTER NOT INITIALIZED 
Meaning 

The INITCODE control was specified, and the register initialization record does not 
contain information for initialization of the 8086 DS (data segment) register. 

Cause 

This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 

Effect 

The value of the DS register at program execution is entirely dependent on the loader 
of your system. 

User Action 

Correct your code if necessary, then reinvoke LINK86. 

WARNING 69: OVERLAPPING DATA RECORDS 
Meaning 

The FASTLOAD control was specified, and two data records belonging to the same 
segment have offsets which make them overlapping. 

Cause 

This warning is usually the result of a translation error, unless you have intentionally 
overlapped data records. 

Effect 

LINK86 ignores the second record and does not include it in the output file. The 
code will be unusable. 

User Action 

If you want an overlap condition to exist, reinvoke, but do not use the FASTLOAD 
control. Otherwise, retranslate, then reinvoke LINK86. 

WARNING 70: INITCODE CONTROL INEFFECTIVE WITH BIND 
CONTROL 

Meaning 

The INITCODE and BIND controls were combined in one invocation statement. 
Effect 

The INITCODE control will be ignored by LINK86. 
User Action 

Do not invoke LINK86 using both of these controls at the same time. To invoke 
them separately, use the INITCODE control first, then the BIND control during a 
second invocation. 
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WARNING 71: TOO MANY MAIN MODULES IN INPUT 

FILE: pathname 
MODULE: module name 

Meaning 

LINK86 discovered two or more main modules (modules with start addresses) in the 
input list. 

Cause 

The input list contains too many main modules. 
Effect 

LINK86 uses the start address of the first main module it reads and ignores the 
others. The object code will be valid. 

User Action 

Ensure that the LINK86 interpretation is suitable to your objectives. If not, modify 
the input list, and reinvoke LINK86. 

UARNING 72: REGISTER INITIALIZATION CODE EXISTS, NEW 
INITIALIZATION IGNORED 
FILE: pathname 
MODULE: module name 

Meaning 

Two or more initialization codes for 8086 registers were encountered in the input 
list. 

Cause 

This condition resulted from a translation or linkage problem. 
Effect 

LINK86 uses the first initialization code and ignores the others. The object code will 
be valid. 

User Action 

If retranslating or relinking does not correct the error, contact Intel. 

WARNING 73: INITCODE CONTROL INEFFECTIVE WITH OVERLAYS 
Meaning 

Both INITCODE and OVERLAY controls were specified. 
Effect 

The INITCODE control is ignored. The object code will be valid. 
User Action 

Reinvoke LINK86, using the INITCODE control. In a second invocation, specify 
the OVERLAY control. 
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ERROR 74: PRINT FILE SAME AS INPUT FILE 
FILE: pathname 

Meaning 

The pathnames of the print file and one of the input files are identical. 
Effect 

LINK86 terminates processing immediately. 
User Action 

Reinvoke LINK86 after fixing the duplicate-name situation. 



ERROR 75: PRINT FILE SAME AS OUTPUT FILE 
Meaning 

The names of the print and output files are identical. 
Cause 

The invocation line included duplicate names. 
Effect 

LINK86 terminates processing immediately. 
User Action 

Correct the invocation line and reinvoke LINK86. 



WARNING 76: BASE OF REFERENCED SEGMENT DIFFERS FROM BASE 
OF CONTAINING GROUP 
FILE: pathname 
GROUP: group name 
MODULE: module name 
SEGMENT: segment name 

Meaning 

An assembly language reference to the base of the specified segment in the specified 
group exists. However, the specified segment is not the first segment in the group. 
This warning occurs only when BIND is in effect. 

Cause 

Unless you have deliberately created this reference, this warning is most likely the 
result of an incorrect ASSUME directive or an incorrect OFFSET operator 
specification. 

Effect 

LINK86 will process the specified reference to the segment base rather than to the 
group base. The output module will be valid. 

User Action 

If the reference to the segment base was deliberate, continue debugging your 
assembly language code as planned. Otherwise, check the correctness of the code, 
particularly the ASSUME directives and OFFSET operator specifications; then 
reassemble and relink. 
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WARNING 77: REFERENCED OFFSET IN SEGMENT DIFFERS FROM 
OFFSET FROM GROUP BASE 
FILE: pathname 
GROUP: group name 
MODULE: module name 
SEGMENT: segment name 

Meaning 

An assembly language reference to an offset from the base of the specified segment 
in the specified group exists. However, the specified segment is not the first segment 
in the group. This warning occurs only when BIND is in effect. 

Cause 

Unless you have deliberately created this reference, this warning is most likely the 
result of an incorrect ASSUME directive or an incorrect OFFSET operator 
specification. 

Effect 

LINK86 will process the specified reference as an offset from the segment base 
rather than the group base. The output module will be valid. 

User Action 

If the reference to the offset in the segment was deliberate, continue debugging your 
assembly language code as planned. Otherwise, check the correctness of the code, 
particularly the ASSUME directives and OFFSET operator specifications; then 
reassemble and relink. 
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Table E-1 lists all of CREF86's control syntax, abbreviations, and default settings. 



Table E-1 . Summary of CREF86 Controls 



Control 


Abbrev. 


Default 


PAGELENGTH(numiber) 


PL 


PAGELENGTH(60) 


PAGE\N\DJH{number) 


PW 


PAGEWIDTH(120) 


PRmj {pathname) 


PR 


PRINT (first input file .CRF) 


TnLE{character-string ) 


TT 


Not applicable 



The following are descriptions of all CREF86 error and warning messages. The 
description of each message has up to four parts: 

• Meaning — how to interpret the message 

• Cause — the usual reason for the error or warning condition 

• Effect— the state of CREF86 and the object f ile(s) after the message is issued 

• User Action — what you can do to correct the condition 

Not all these parts are given for each message. However, parts excluded are self- 
explanatory. 

Error messages are always fatal, but warning messages are not. 

Error and warning messages are displayed at the console device, but printed only if a 
listing would otherwise be printed. 



ERROR 1: I/O ERROR 

operating system message explaining ttie cause of this erorr 
FILE: pathname 

Meaning 

An I/O error was detected. See the appropriate operating system documentation for 
interpretation. 

Effect 

CREF86 immediately terminates processing; all open files are closed. The contents 
of the print file are undefined. 

User Action 

Correct the error and restart CREF86. 
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ERROR 2: SYNTAX ERROR IN INPUT COMMAND 
Meaning 

An error in the syntax of the invocation line was detected. 
Cause 

This condition is usually the result of a typographical error or transposition. 
Effect 

The invocation command line, to the point it is parsed, is written to the console with 
a # following this string. 

User Action 

Correct the syntactic error and retransmit the invocation line(s). 

ERROR 3: OUT OF MEMORY 
Meaning 

CREF86 does not have enough memory to create its internal data structures, tables, 
etc. This condition may also occur because of inadequate disk space for temporary 
files. 

Cause 

The input list contains too many symbols and/or too many references among them. 
Effect 

CREF86 immediately terminates processing, closing all open files. The contents of 
the print file are undefined. 

User Action 

Ensure that adequate resources are available to run CREF86. 

ERROR 4: I/O ERROR 

operating system error message 
FILE: pathname 

Meaning 

An I/O error was detected. See the appropriate operating system documentation for 
interpretation. 

Effect 

CREF86 processing is immediately terminated. 
User Action 

Correct the error and restart CREF86. 
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ERROR 5: IMPROPER OBJECT MODULE 
FILE: pathname 
MODULE: module name 

Meaning 

The specified module does not meet 8086 object module requirements. 
Cause 

This condition may be caused by the translator or by an error in data transmission. 
Effect 

CREF86 processing is immediately terminated. 
User Action 

Try retranslating the source file. If the problem persists, call Intel. 

ERROR 6: PREMATURE EOF 
FILE: pathname 

Meaning 

CREF86 expects more input data, but encounters an end-of-file (EOF) condition. 
Cause 

This condition usually results from a translator error. 
Effect 

CREF86 processing is immediately terminated. 
User Action 

Return to the previous step in program development, then retranslate or relink. 

ERROR 7: LIBRARY SEEK ERROR 
FILE: pathname 
MODULE: module name 

Meaning 

CREF86 did not encounter a proper library record when scanning a library file. 
Cause 

The library file or the disk may be corrupted. 
Effect 

CREF86 immediately terminates processing. 
User Action 

Reinvoke CREF86 after replacing the file or the disk. 
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ERROR 8: LIBRARY IN OVERLAY MODE 
FILE: pathname 

Meaning 

An input list contains object file(s) with an overlay record count greater than zero 
and a library file. 

Cause 

Libraries cannot contain overlay records. CREF86 can process either all modules or 
no modules with overlay records. 

Effect 

CREF86 immediately terminates processing. 
User Action 

Reinvoke CREF86 using a valid input list. 



ERROR 9: IMPROPER MODULE SEQUENCE 
FILE: pathname 
MODULE: module name 

Meaning 

A combination of modules containing overlay records with those containing 
nonoverlay records was encountered in the input list. 

Cause 

CREF86 can process input lists consisting of either all modules with overlay records 
or no modules with overlay records. 

Effect 

CREF86 immediately terminates processing. 
User Action 

Reinvoke CREF86 with a valid input list. 
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ERROR 10: MORE THAN 255 OVERLAYS NOT SUPPORTED 
Meaning 

The input list contains over 255 files with overlay records. 
Cause 

CREF86 does not support more than 255 overlay files. In the case of input lists 
without overlays, however, there is no limit (except available memory) on the 
number of files CREF86 can process. 

Effect 

CREF86 immediately terminates processing. 
User Action 

Reinvoke CREF86 using fewer than 255 overlay files. 



ERROR 11: TOO MANY OVERLAYS 
FILE: pathname 
MODULE: module name 

Meaning 

The input file contains more than one overlay. 
Cause 

CREF86 can support files with only one overlay record each. 
Effect 

CREF86 terminates processing immediately. 
User Action 

Reinvoke CREF86 with an input list containing files with no more than one overlay 
each. 
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ERROR 12: I/O ERROR 
operating system error message 
FILE: pathname 

Meaning 

An I/O error was detected. See the appropriate operating system documentation for 
interpretation. 

Effect 

CREF86 terminates processing immediately. 
User Action 

Correct the error and restart CREF86. 



ERROR 13: IMPROPER PAGE WIDTH SPECIFICATION 
Meaning 

The PAGE WIDTH control specification includes a number outside the valid 
syntactic range. 

Effect 

CREF86 terminates processing immediately. 
User Action 

Correct the syntax error and reinvoke CREF86. CREF86 accepts a PAGE WIDTH 
number m decimal form from 80 to 132, inclusive, in the following format: 

PAGEWIDTH(/7umibe/-) 
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ERROR 14: IMPROPER PAGE LENGTH SPECIFICATION 
Meaning 

The PAGELENGTH control specification includes a number outside the valid 
syntactic range. 

Effect 

CREF86 terminates processing immediately. 
User Action 

Reinvoke CREF86 using the proper PAGELENGTH syntax. CREF86 accepts a 
PAGELENGTH number in decimal form from 10 through 255, in the following 
format: 

PAGELENGTH (/7iy/n6er) 



ERROR 15: ILLEGAL LIBRARY FILE 
FILE: pathname 

Meaning 

CREF86 did not encounter a proper hbrary record in the proper location. 
Cause 

The library file or disk may be corrupted. 
Effect 

CREF86 terminates processing immediately. 
User Action 

Reinvoke CREF86 after replacing the file or the disk. 
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ERROR 16: IMPROPER OBJECT FILE 
FILE: pathname 
MODULE: module name 

Meaning 

CREF86 did not encounter an 8086 object module record in the proper location. 
Cause 

The object file may be corrupt or the file may not be an 8086 object file. 
Effect 

CREF86 terminates processing immediately. 
User Action 

Determine whether the integrity of the object file is intact and whether the file is a 
proper input file for CREF86. Reinvoke CREF86 with a valid and usable object file. 



ERROR 17: OUTPUT FILE SAME AS INPUT FILE 
FILE: pathname 
MODULE: module name 

Meaning 

CREF86 detected an output pathname identical to an input pathname. 
Cause 

The invocation line specified two identical pathnames. 
Effect 

CREF86 terminates processing immediately. 
User Action 

Reinvoke CREF86 after fixing the duplicate-name situation. 
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ERROR 18: CREF86 INTERNAL ERROR 
FILE: pathname 
MODULE: module name 

User Action 

Contact Intel immediately. Forward a copy of the object file, the CREF86 invoca- 
tion line, and your version of CREF86. 



WARNING 19: TYPE MISMATCH 
FILE: pathname 
MODULE: module name 
SYMBOL: symbol name 

Meaning 

CREF86 detected a type mismatch between two symbols with the same name. 
Cause 

Two symbols are declared to have identical names but different types, and the 

symbols are not in different overlay modules. 

CREF86 does not check the entire TYPE declaration for any given symbol. For 
example, dimension values for arrays, number of parameters in procedure calls, etc. 
are not compared. Only simple types (e.g., byte, word, structure) are checked. 

Effect 

CREF86 flags the condition in the cross-reference listing. 
User Action 

Ensure that the condition is not damaging to your programming objectives. 
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WARNING 20: SPECIFIED MODULE NOT FOUND 
FILE: pathname 
MODULE: module name 

Meaning 

A module explicitly included in the input list of the invocation is not found by 
CREF86. 

Cause 

The specified module is not part of the file specified by the pathname. 
Effect 

CREF86 continues processing the modules it is able to find. 
User Action 

Determine why the module is missing, then reinvoke CREF86. 



ERROR 21: OPERATING SYSTEM INTERFACE ERROR 
operating system error message 

Meaning 

CREF86 cannot open its temporary file. 
Effect 

CREF86 terminates processing immediately. 
User Action 

Refer to the documentation on the operating system to help diagnose any possible 
operating system malfunction. 
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The table below shows all of LIB86's commands. 



Table F-1 . Summary of LIB86 Commands 



Command 


Abbrev. 


Description 


ADD ipathname[(module name[,...])]y 
[,...] JO pathname 


A 


Adds modules to a library 


CREATE pathname 


C 


Creates a library file 


DELETE pathnameimodule name [,...]) 


D 


Deletes modules from a library 

file 


EXIT 


E 


Terminates session with LIB86 


LIST ipathname[(moclule name [,...])]> 
[,...] [JO pathname] [PUBLICS] 


L 

[P] 


Lists modules contained in a 
library file, and optionally lists 
all publics 



The following are descriptions of all LIB86 error and warning messages. The 
description of each message has up to four parts: 

• Meaning — how to interpret the message 

• Cause — the usual reason for the error or warning condition 

• Effect— the state of LIB86 and the object file(s) after the message is issued 

• User Action — what you can do to correct the condition 

Not all these parts are given for each message. However, parts excluded are self- 
explanatory. 

Error and warning messages are displayed at the console device. 

MODULE NOT FOUND 
MODULE: module name 
FILE: pathname 

Meaning 

The specified module could not be found in the specified library. 
Cause 

There is a typographical error in the command line. 
Effect 

LIB86 ignores the module in the list and continues processing. 

User Action 

No user action is necessary. 
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RIGHT PARENTHESIS EXPECTED 
partial command tail 



LEFT PARENTHESIS EXPECTED 
partial command tail 



INVALID MODULE NAME 
partial command tail 



MODULE NAME TOO LONG 
partial command tail 



INVALID SYNTAX 
partial command tail 



'TO' EXPECTED 
partial command tail 

Meaning 

All of the above errors are syntax errors. For each of the above errors LIB86 issues 
the associated error message and displays the partial command up to the point of the 
error. 

Cause 

There is a typographical error in the command line. 
Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Examine the command line, make the necessary corrections and reissue the 
command. 
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UNRECOGNIZED COMMAND 
Cause 

You mistyped a command (ADD, CREATE, DELETE, EXIT, or LIST). 
Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Examine the conimand line and enter the corrected command. 

INSUFFICIENT MEMORY 
Meaning 

There is not enough memory available to execute the command. 
Cause 

Exceptionally long and complex commands can cause this error. 
Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Simplify your command line and reexecute. 

COMMAND LINE TOO LONG 
partial command tail 

Meaning 

The length of the L1B86 command you tried to execute exceeded the size limit of the 
system's command buffer. 

Effect 

LIB86 immediately terminates processing the command, displays this error message 
plus the portion of the command it would accept, then issues the prompt character 
(*). 

User Action 

Simplify your command line and reexecute. 
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LIB86 ERROR 
Meaning 

LIB86 failed an internal consistency check. 
Effect 

LIB86 immediately terminates processing. The results of previous commands on the 
library being manipulated when this error occurred may have been lost. 

User Action 

Contact Intel. Forward a copy of the libraries and object files used during the 
session in which the error occurred. 

FILE ALREADY EXISTS 
FILE: pathname 

Meaning 

The file specified in the CREATE command already exists. 
Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Specify a nonexistent file in the CREATE command. 

DUPLICATE SYMBOL IN INPUT 
SYMBOL: symbol name 
MODULE: module name 
FILE: pathname 

Meaning 

The specified public symbol conflicts with a public symbol defined in one of the files 
given earlier in the input list. This error occurs only during the ADD command. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). The library being manipulated returns to the 
state it was in prior to the ADD command that prompted this message. 

User Action 

Correct the ADD command and reinvoke LIB86. 
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NOT A LIBRARY 
FILE: pathname 

Cause 

The file that the command requests LIB86 to DELETE or LIST is not a library file. 
Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Reissue the command specifying a library file. 

ILLEGAL RECORD FORMAT 
MODULE: module name 
FILE: pathname 

Cause 

This error is usually caused by a transcription error or translation error in some part 
of an object file examined by LIB86. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Return to the last step in program development, then retranslate, relink, or relocate. 

PREMATURE EOF 
MODULE: module name 
FILE: pathname 

Meaning 

Due to some transcription error or other the specified file has no module end record. 
Cause 

This is usually the result of a transcription error or translator error. 
Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Return to the last step in program development, then restranslate, relink, or 
relocate. 
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CHECKSUM ERROR 
MODULE: module name 
FILE: pathname 

Meaning 

The specified file has an error in one of its checksum fields. 
Cause 

This is the result of a transcription error. 
Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Return to the last step in program development, then retranslate, relink, or relocate. 

ATTEMPT TO ADD DUPLICATE MODULE 
MODULE: module name 

Meaning 

A module with the specified module name already exists in the library. 
Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Remove the duplicate module from the list and reissue the command. 

ATTEMPT TO ADD MODULE CONTAINING OVERLAYS 
MODULE: module name 
FILE: pathname 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). All modules in the input list up to the erroneous 
file are added to library. 

User Action 

Reissue the command with all elements in the input list except those that contain 
overlays. 
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PUBLIC SYMBOL ALREADY IN LIBRARY 
SYMBOL: symbol name 
MODULE: input module name 
FILE: input pathname 

Meaning 

The library already contains the public symbol identified in the error message. 
Cause 

This error occurs when a module is added that has a symbol definition already in the 
library. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Reexecute the command without the file that contains the duplicate symbol. 
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Table G-1 lists all of LOC86's control syntax, abbreviations, and default settings. 



Table G-1 . Summary of LOC86 Controls 



Control 


Abbrev. 


Default 


ADDRESSES( 

{SEGMENTS('Cs6gfmen/[ \class[\overl3y]] 
(addr)}[,...]) 1 

GHOUPS(igroup(addr)y[,...]) } 
r 1 \ 


AD 
(SM 1 
CS 1 GR) 


Not applicable 


BOOTSTRAP 


BS 


Not applicable 


COMMENTS 


CM 


COMMENTS 


NOCOMMENTS 


NOCM 


\mCODE[(address)] 


IC 


INITCODE(200H) 


NOINITCODE 


NOIC 


LINES 


LI 


LINES 


NOLINES 


NOLI 


MAP 


MA 


MAP 


NOMAP 


NOMA 


N AME(/770c/u/e name) 


NA 


Not applicable 


OBJECTCONTROLS( 

KLINES 1 NOLINES | 
COMMENTS 1 NOCOMMENTS | 
SYMBOLS 1 NOSYMBOLS | 

PURGE 1 NOPURGE> [,...]) 


OC 


Not applicable 


ORDER( 

locLiMbN 1 ^{xSeymenil \CiaSS[\OVBnay\\J 

[,-]) 1 

CLA3oE3{\ciBss[(segment i,...J)j> t»'"J)-'^ 

[■-]) 


OD 
(bWI 1 

CS) 


Not applicable 


Pr\\Hl[(pathname)] 


PR 


PRINT(o6/ecfff/e.MP2) 


NOPRINT 


NOPR 


PRINTCONTROLS( 

. {LINES 1 NOLINES | 
COMMENTS 1 NOCOMMENTS | 
SYMBOLS 1 NOSYMBOLS | 
PUBLICS 1 NOPUBLICS | 
PURGE 1 NOPURGE> [,...]) 


PC 


Not applicable 


PUBLICS 


PL 


PUBLICS 


NOPUBLICS 


NOPL 


PURGE 


PU 


NOPURGE 


NOPURGE 


NOPU 
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Table G-1 . Summary of LOC86 Controls (Cont'd.) 



Control 


Abbrev. 


Default 


RESER\/E(<.addrJOaddry [,...]) 


RS 


Not applicable 


SEGS\ZE(isegment[ \class[\overlay]] 


88 


Not applicable 


STARK <sym£)o/ | paragraph , offset}) 


ST 


Not applicable 


SYMBOLS 


SB 


SYMBOLS 


NOSYMBOLS 


NOSB 


SYMB0LC0LUMNS({1 |2|3| 4» 


SC 


SYMB0LC0LUMNS(2) 



The following are descriptions of all LOC86 error and warning messages. The 
description of each message has up to four parts: 

• Meaning— how to interpret the message 

• Cause — the usual reason for the error or warning condition 

• Effect— the state of LOC86 and the object file(s) after the message is issued 

• User Action — what you can do to correct the condition 

Not all these parts are given for each message. However, parts excluded are self- 
explanatory. 

Error messages are always fatal, but warning messages are not. In the event of a 
warning, read the EFFECT of the warning carefully to determine whether the code 
is valid. 

Error and warning messages are displayed at the console device, but printed only if a 
listing would otherwise be printed. 



ERROR 1 : I/O ERROR: 

operating system error message 

Meaning 

An I/O error was detected. Refer to the documentation for your operating system 
for interpretation. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Correct the error and restart LOC86. 
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ERROR 2: INVALID SYNTAX 

ERROR IN COMMAND TAIL NEAR #: 
partial command tail 

Meaning 

A syntax error was detected in the invocation line. LOC86 repeats the invocation 
line up to the point of the error. 

Cause 

This is usually the result of a typographical error in the invocation line. 
Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reenter the invocation line more carefully. 

ERROR 3: MISSING INPUT FILE NAME 
ERROR IN COMMAND TAIL NEAR #: 

partial command tail 

Meaning 

LOC86 was unable to find the input file name in the invocation. LOC86 repeats the 
invocation line up to the point of the error. 

Cause 

This is usually the result of a typographical error in the invocation line. 
Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reinvoke LOC86 more carefully. 
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ERROR 4: INSUFFICIENT MEMORY 
Meaning 

The memory available on your system has been used up by LOC86. 
Cause 

This can be caused by an input module that has a very large number of segments or 
an impossibly long invocation line. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

This may require changing the source file to reduce the number of segments and 
retranslating. 

ERROR 5: BAD RECORD FORMAT 
MODULE: module name 

Meaning 

There is a record in the specified input module that has an incorrect format. 
Cause 

This is usually a transcription error. 
Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Retranslate and relink the input files before attempting to locate the input module 
again. 
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ERROR 6: INVALID KEY WORD 

ERROR IN COMMAND TAIL NEAR U: 
partial command tail 

Meaning 

One of the controls or subcontrols in the invocation line is incorrect. LOC86 repeats 
the invocation line up to the point of the error. 

Cause 

This is usually the result of a typographical error in the invocation line. 
Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reinvoke LOC86 more correctly. 

ERROR 7: NUMERIC CONSTANT LARGER THAN 20 BITS 
ERROR IN COMMAND TAIL NEAR U: 
partial command tail 

Meaning 

You have specified an address greater than 1,048,575 (OFFFFFH). LOC86 repeats 
the invocation line up to the point of the error. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and invoke LOC86 with the correct address. 

ERROR 8: NON NUMERIC CHARACTER IN NUMERIC CONSTANT 
ERROR IN COMMAND TAIL NEAR U: 
partial command tail 

Meaning 

This is a type of syntax error. LOC86 repeats the invocation line up to the point of 
the error. 

Cause 

This is usually caused by a typographical error in the invocation line. 
Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Enter the invocation more carefully. 
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ERROR 9: NUMERIC CONSTANT LARGER THAN 16 BITS 
ERROR IN COMMAND TAIL NEAR #: 
partial command tail 

Meaning 

You have specified an offset greater than 65,536 (OFFFFH). LOC86 repeats the 
invocation line up to the point of the error. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Retype the invocation line more carefully. 

ERROR 10: INVALID SEGMENT NAME 
ERROR IN COMMAND TAIL NEAR #: 
partial command tail 

Meaning 

LOC86 was expecting a segment name when it found a token that does not cor- 
respond to a valid segment name. LOC86 repeats the invocation line up to the point 
of the error. 

Cause 

This is usually the result of a typographical error. 
Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reinvoke LOC86 more carefully. 
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ERROR 11: INVALID CLASS NAME 
ERROR IN COMMAND TAIL NEAR 

partial command tail 

Meaning 

LOC86 was expecting a class name when it found a token that does not correspond 
to a valid class name. LOC86 repeats the invocation line up to the point of the error. 

Cause 

This is usually the result of a typographical error. 
Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reinvoke LOC86 more carefully. 



ERROR 12: INVALID INPUT MODULE 
MODULE: module name 

Meaning 

The input module is invalid. It could mean that object module records are out of 
order, or LOC86 has found an invalid field within a record, or a required record is 
missing. 

Cause 

This is usually caused by a translator error or an attempt to locate something other 
than an object file (e.g., a source file). 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Retranslate source and relink, then try to locate again. If this error continues contact 
Intel. 
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WARNING 13: MORE THAN ONE SEGMENT WITH THE MEMORY 
ATTRIBUTE 
SEGMENT: segment name 

Meaning 

After the first memory segment is found, LOC86 issues this warning each time it 
finds a segment with the memory attribute. 

Effect 

LOC86 ignores the memory attribute on the segment specified in the message. Pro- 
cessing continues with LOC86 treating the additional memory segment as just 
another segment. 

User Action 

Depending on your intentions, this message may be ignored or you may wish to 
change the attribute for the segments and relink them. 



WARNING U: GROUP DEFINED BY AN EXTERNAL REFERENCE 
NAME: external name 
GROUP: group name 



Meaning 

The specified group is defined by an external reference. This is a type of unresolved 
external reference. 

Effect 

LOC86 continues processing without side effects. 
User Action 

Find the module that defines the specified symbol and relink the input module. 



WARNING 15: PUBLIC SYMBOL NOT ADDRESSABLE 
NAME: public symbol name 

Meaning 

The specified symbol is more than 64K from its base. This error occurs when the seg- 
ment containing the public symbol is not completely contained within the 64K 
physical segment defined by the symbol's base. 

Effect 

LOC86 continues processing. The object file will be executable. However, any 

attempt to access the specified public symbol will not produce the desired results. 
Debug symbols with this attribute will not be added to the object file. 

User Action 

Change the ORDER or ADDRESSES control so that the segment containing the 
public symbol will be within range of the symbol's base. 
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WARNING 16: LOCAL SYMBOL NOT ADDRESSABLE 
NAME: local symbol name 

Meaning 

The specified symbol is more than 64K from its base. This error occurs when the seg- 
ment containing the local symbol is not completely contained within the 64K 
physical segment defined by the symbol's base. 

Effect 

LOC86 continues processing. The object file will be executable. However, any 
attempt to access the specified symbol will not produce the desired results. Debug 
symbols with this attribute will not be added to the object file. 

User Action 

Change the ORDER or ADDRESSES control so that the segment containing the 
local symbol will be within range of the symbol's base. 



WARNING 17: LINE NUMBER NOT ADDRESSABLE 
NAME: line number 

Meaning 

The specified line is more than 64K from its base. This error occurs when the seg- 
ment containing the line number is not completely contained within the 64K physical 
segment defined by the line's base. 

Effect 

LOC86 continues processing. The object file will be executable. However, any 
attempt to access the specified line number will not produce the desired results. 
Debug symbols with this attribute will not be added to the object file. 

User Action 

Change the ORDER or ADDRESSES control so that the segment containing the line 
number will be within range of the line's base. 
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WARNING 18: SIZE OF GROUP EXCEEDS 64K 
GROUP: group name 

Meaning 

Some of the segments of the specified group are not contained within the physical 
segment defined by the group's base. 

Cause 

This error is usually caused by misuse of the ORDER or ADDRESSES control. 
Effect 

LOC86 continues processing the input module. The output module will be 
executable, but addressing errors may result. 

User Action 

Examine the invocation line and reinvoke LOC86 using the ORDER or 
ADDRESSES control more carefully. 

WARNING 19: BOOTSTRAP SPECIFIED FOR MODULE WITHOUT START 
ADDRESS 

Meaning 

You have specified BOOTSTRAP when locating a module that has no start address. 
Effect 

LOC86 continues processing as if no BOOTSTRAP control was specified. 
User Action 

If you wish initialization code in the program, relocate the input module specifying 
both BOOTSTRAP and START . 

ERROR 20: INVALID NAHE 
NAME: bad name 

Cause 

This is the result of a typographical error in the NAME control. A valid name is 
composed of up to forty of the following characters in any order: 

• Alphabetic (A, B, C, Z) 

• Numeric (0, 1,2, 9) 

• Special (@, ?,:, .,_) 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reinvoke LOC86 more carefully. 
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ERROR 21: SEGMENT REGISTER DEFINED BY SPECIFIED EXTERNAL 
NAME 

NAME: external name 
Meaning 

A segment register or register pair is defined using the specified external symbol 
name. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Relink and relocate your object modules. 



ERROR 22: SEGMENT SIZE OVERFLOW; OLD SIZE + CHANGE > 64K 
SEGMENT: segment name 
CLASS: class name 

Meaning 

The size change specified in the SEGSIZE control caused the segment to become 
greater than 64K. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Look at the segment's size in the link map and reinvoke LOC86 with the correct 
SEGSIZE control. 



ERROR 23: SEGMENT SIZE UNDERFLOW; OLD SIZE - CHANGE < 0 
SEGMENT: segment name 
CLASS: class name 

Meaning 

The size change specified in the SEGSIZE control caused the segment's size to be 
less than zero. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Look at the segment's size in the link map and reinvoke LOC86 with the correct 
SEGSIZE control. 
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ERROR 24: INVALID ADDRESS RANGE 
Meaning 

The arguments to the RESERVE control are invalid. 
Cause 

The usual cause of this error is that the low address is larger than the high address. 
Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 

ERROR 25: PUBLIC SYMBOL NOT FOUND 
NAME: public symbol name 

Meaning 

The symbol specified in the START control was not found. 
Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Either specify the argument to START with paragraph and offset, or specify an 
existing public symbol. 

WARNING 26: DECREASING SIZE OF SEGMENT 
SEGMENT: segment name 

Meaning 

The size change specified in SEGSIZE has caused LOC86 to decrease the size of the 
specified segment. 

Effect 

Decreasing the size of a segment can cause sections of code to be unaccounted for 
during the locating process. This is only a warning message. LOC86 continues pro- 
cessing with no side effects. 

User Action 

If the size decrease was not intended, examine the SEGSIZE control in the invoca- 
tion line and relocate. 
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ERROR 27: SPECIFIED SEGMENT IS ABSOLUTE 
SEGMENT: segment name 

Meaning 

You attempted to assign an address to an absolute segment. 
Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reinvoke LOC86 without using absolute segments in the ADDRESSES control. 



WARNING 28: PAGE RESIDENT SEGMENT CROSSES PAGE BOUNDARY 
SEGMENT: segment name 

Cause 

If you have changed the specified segment's size, it may be too large to fit within a 
256 byte page, or if you have specifed an address for the segment, it may force the 
segment to cross a page boundary. 

Effect 

Since this error can only occur when you have intentionally specified the segment in 
a control, LOC86 ignores the page resident attribute and continues to process the 
module as if no error has occurred. 

User Action 

If you have invoked LOC86 correctly, then the message is only verifying your inten- 
tions — no action is necessary. 
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WARNING 29: OFFSET FIXUP OVERFLOW 
MODULE: module name 
REFERENCED LOCATION: 20-bit address 
FRAME OF REFERENCE: 20-bit address 

Meaning 

While computing an offset from a base (FRAME OF REFERENCE), LOC86 found 
that the REFERENCED LOCATION was more than 64K bytes away from the base. 

Cause 

This error usually occurs as a result of misuse of the ORDER or ADDRESSES 
control. One of the segments of a group is outside the 64K byte physical segment 
defined by its group base. 

Effect 

LOC86 continues processing. The print file will be valid, but the output file with 
regard to the out-of -place segment will not be usable. 

User Action 

Find the symbol that corresponds to the referenced location, and change the 
ORDER or ADDRESSES control. 



WARNING 30: UNRESOLVED EXTERNAL REFERENCE TO NAME 
AT SPECIFIED ADDRESS 
NAME: symbol name 
SEGMENT: segment name 
ADDRESS: 20-bit address 

Meaning 

There is no public definition for the specified public symbol. There is an unresolved 
external reference to that symbol in the specified segment. 

Cause 

You are locating a module that is not completely linked. 
Effect 

LOC86 continues processing with no side effects. The print file will be valid, and 
except for the unresolved references the object file should be executable. 

User Action 

No action is necessary if the unresolved reference is known. Otherwise, you must 
relink and resolve the external reference. 
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WARNING 31: UNRESOLVED EXTERNAL REFERENCE TO NAME NEAR 
SPECIFIED ADDRESS 
NAME: symbol name 
SEGMENT: segment name 
ADDRESS: 20-bit address 

Meaning 

There is no public definition for the specified public symbol. There is an unresolved 
external reference to that symbol in the specified segment. 

Cause 

You are locating a module that has not been completely linked. 
Effect 

LOC86 continues processing with no side effects. The print file will be valid, and 
except for the unresolved references the object file should be executable. 

User Action 

No action is necessary if the unresolved reference is known. Otherwise, you must 
relink to resolve the external reference. 



WARNING 32: OVERFLOW OF LOW BYTE FIXUP VALUE 

MODULE: module name 

REFERENCED LOCATION: 20-bit address 

FRAME OF REFERENCE: 20-bit address 

Meaning 

An 8-bit displacement value, when calculated, exceeded 255. 
Cause 

This type of error often occurs when a page resident segment crosses a page 
boundary. 

Effect 

LOC86 continues processing. The contents of both the print file and the object file 
will be valid. However, the fixup value will remain invalid. 

User Action 

Find the symbol that corresponds to the REFERENCED LOCATION and organize 
your segments so that the addressing error will not be encountered. 
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WARNING 33: GROUP HAS NO CONSTITUENT SEGMENTS 
GROUP: group name 

Meaning 

The group has no segments and is not placed in the output object file. 
Cause 

Often this is the result of a typographical error in the invocation line. However, it 
may be a linking error that has not shown up until now. 

Effect 

LOC86 continues processing with no side effects. 
User Action 

Unless there is some particular need for the specified group, no user action is 
necessary. 



ERROR 34: SPECIFIED CLASS NOT FOUND IN INPUT MODULE 
CLASS: class name 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Find the module that contains the specified class and link it into the module to be 
located. 



ERROR 35: SPECIFIED SEGMENT NOT FOUND IN INPUT MODULE 
SEGMENT: segment name 
CLASS: class name 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Find the module that contains the specified segment and link it into the module to be 
located. 
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WARNING 36: SEGMENTS OVERLAP 
SEGMENT: segment name 
SEGMENT: segment name 
LOW OVERLAP ADDRESS: 20-bit address 
HIGH OVERLAP ADDRESS: 20-bit address 

Meaning 

The two segments overlap in the specified address range. 
Cause 

This can be caused by any number of things: mistake in the SEGSIZE control, 
misuse of ADDRESSES, or two absolute segments that overlap. 

Effect 

LOC86 continues processing the input module. The print file is valid, and the object 
file, with the exception of the overlap, should be usable. 

User Action 

If overlap was intended, no action is necessary. Otherwise, depending on the cause 
of the message, it may be necessary to relocate or even modify the source, and 
retranslate, relink, and relocate. 



ERROR 37: INPUT MODULE EXCEEDS 8086 MEMORY 
SEGMENT: segment name 

Meaning 

While attempting to locate the specified segment, LOC86 ran out of available 8086 
address space. 

Cause 

Although it is possible to write a program that uses a full megabyte of memory, this 
error usually results from an error in the arguments to the RESERVE control. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the RESERVE control. If, in fact, your program requires more than 
1 ,048,576 bytes of memory, try optimizing with ASM86 or use overlays. 
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WARNING 38: SEGMENT WITH MEMORY ATTRIBUTE NOT PLACED 
HIGHEST IN MEMORY 
SEGMENT: segment name 

Meaning 

The specified memory segment was not located at the highest address in memory. 
Cause 

This can only occur when you explicitly request this organization through the 
ORDER or ADDRESSES control, or when you implicitly request it by assigning 
another segment to the top of memory. 

Effect 

Since this can only occur by user request, LOC86 continues processing without side 
effects. 

ERROR 39: NO MEMORY BELOW SEGMENT FOR SPECIFIED SEGMENT 
SEGMENT: segment name 
SEGMENT: segment name 

Meaning 

In the ORDER control you have requested that the first segment be located below 
the second segment. LOC86 found that there is not enough memory to maintain this 
order. 

Cause 

This error can only occur when one of the segments in an ORDER control is 
absolute. The absolute segment is not necessarily either of the segments specified in 
the command. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Modify the order control. 
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WARNING 40: CANNOT MAINTAIN SPECIFIED ORDERING 
SEGMENT: segment name 

Meaning 

LOC86 cannot locate all of the segments in the ORDER control consecutively. 
Cause 

This is usually caused by specifying absolute segments in the ORDER control or by 
specifying the same segments in ORDER and ADDRESSES. The conflict might not 
be immediately obvious. For example, the specified segment may be specified in the 
ORDER control by its segment name and specified in the ADDRESSES control by 
its class name. 

Effect 

LOC86 continues processing. The print and object files are valid. However, the 
requested segment ordering is not maintained. 

User Action 

Carefully examine your invocation line to find the conflict and relocate the input 
module. 



ERROR 41: SPECIFIED CLASS OUT OF ORDER 
CLASS: class name 

Meaning 

The ORDER control and ADDRESSES control for the specified class disagree. 
Cause 

Either you have assigned an address to the specified class or one of its constituent 
segments, or the translator has made one of its constituent segments absolute. In 
either case, the ORDER control cannot be realized. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Modify the ADDRESSES control or modify the ORDER control. 
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ERROR 42: SPECIFIED SEGMENT OUT OF ORDER 
SEGMENT: segment name 

Meaning 

The ORDER control and ADDRESSES control for the specified segment disagree. 
Cause 

Either you have assigned an address to the specified segment or the translator has 
made the segment absolute. In either case, the ORDER control cannot be realized. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Modify the ADDRESSES control or modify the ORDER control. 

ERROR 43: ADDRESS FOR CLASS SPECIFIED MORE THAN ONCE 
CLASS: class name 

Cause 

This is often caused by a typographical error or some other mechanical error while 
entering the invocation line. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 



ERROR 44: SEGMENT ADDRESS PREVIOUSLY SPECIFIED IN INPUT 
MODULE OR COMMAND LINE 
SEGMENT: segment name 
CLASS: class name 

Cause 

Either the specified segment is absolute or it has been listed twice in the same 
ADDRESSES control. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line. If the translator has made it an absolute segment, 
either use the translator-assigned address or retranslate the segment. 
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ERROR 45: SEGMENT SPECIFIED MORE THAN ONCE IN ORDER 
SEGMENT: segment name 
CLASS: class name 

Cause 

This error can be caused by either of two errors in the invocation line. You have 
simply specified the same segment twice in the ORDER control. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and ORDER control and reinvoke LOC86. 

ERROR 46: CLASS SPECIFIED MORE THAN ONCE IN ORDER 
CLASS: class name 

Cause 

You have specified the same class more than once in the same ORDER control. 
Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 

ERROR 47: SPECIFIED SEGMENT NOT IN SPECIFIED CLASS 
SEGMENT: segment name 
CLASS: class name 

Cause 

This error is usually caused by a typographical error in the arguments to an ORDER 
control. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 
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ERROR 48: INVALID COMMAND LINE 
Meaning 

LOC86 has encountered an end-of-file or an I/O error while reading the invocation 
line. 

Cause 

You probably terminated the invocation line in the middle of a control argument. 
Most likely you forgot to type the ampersand before you typed the carriage return. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and reihvoke LOC86 correctly. 



WARNING 49: SEGMENT ALIGNMENT NOT COMPATIBLE WITH 
ASSIGNED ADDRESS 
SEGMENT: segment name 

Meaning 

The alignment attribute does not agree with the address specified in the 
ADDRESSES control. 

Effect 

LOC86 ignores the address assignment and treats the segment as any other 
relocatable segment. 

User Action 

If the address that LOC86 assigns is satisfactory, then no action is necessary. Other- 
wise, examine the print file and assign an address that will agree with the alignment 
attribute. 
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ERROR 50: INVALID COMMAND LINE; TOKEN TOO LONG 
ERROR IN COMMAND LINE NEAR 

partial command tail 

Meaning 

An invocation line "token" is impossibly long. A token is a series of characters that 
are not broken by a parenthesis, a comma or a blank (space, carriage-return, line- 
feed or tab). Tokens are syntactic units used in invocation line parsing. Depending 
on how it is used, a token can be a control word, a symbol name, a segment name, a 
filename, etc. 

Cause 

This is often the result of a typographical error in the invocation line. 
Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 



WARNING 51: REFERENCING LOCATION IS OUTSIDE 64K FRAME OF 
REFERENCE 
MODULE: module name 
ADDRESS: 20-bit address 
FRAME OF REFERENCE: 20-bit address 

Meaning 

The address of a self-relative reference lies outside of the 64K frame of reference of 
the jump or call. This error occurs while locating the module containing the self- 
relative instruction. 

Cause 

This error occurs as a result of misuse of the ORDER or ADDRESSES control. 
Effect 

LOC86 continues processing. The print file is valid, but the object file with respect 
to the module containing the self-relative reference is not executable. 

User Action 

Examine the locate map and reinvoke LOC86 modifying your ORDER and 
ADDRESSES control to correct the error. 
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WARNING 52: REFERENCED LOCATION OUTSIDE 64K FRAME OF 
REFERENCE 
MODULE: module name 
REFERENCED LOCATION: 20-bit address 
FRAME OF REFERENCE: 20-bit address 

Meaning 

The target of a self-relative reference lies outside of the 64K frame of reference of 
the jump or call. This error occurs while locating the module containing the target of 
a self -relative instruction. 

Cause 

This error occurs as a result of misuse of the ORDER or ADDRESSES control. 
Effect 

LOC86 continues processing. The print file is valid, but the object file with respect 
to the module containing the self-relative reference is not executable. 

User Action 

Examine the locate map and reinvoke LOC86 modifying your ORDER and 
ADDRESSES control to correct the error. 



WARNING 53: CANNOT ALLOCATE CLASS AT SPECIFIED ADDRESS 

ADDRESS: 20-bit address 
CLASS: class name 

Meaning 

The specified class cannot be located at the address requested. This is the result of a 
conflict with another address assignment, or an absolute segment, or an address less 
than 200H. 

Effect 

LOC86 assigns the class to the nearest address that will not cause conflict. LOC86 
continues processing, and both the print and object file are valid. 

User Action 

If the alternate address suits your purpose, then no action is necessary. Otherwise, 
examine the locate map and modify your invocation line. 
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ERROR 54: DATA ADDRESS OUTSIDE SEGMENT BOUNDARIES 
SEGMENT: segment name 
MODULE: module name 

Meaning 

One of the data records associated with the specified segment contains an address 
outside of the segment's boundary. 

Cause 

This error can occur when you assign an address or an order to an absolute segment, 
or a size to a segment. Under some circumstances this can be the result of a linkage 
or translation error. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Change the ADDRESSES, ORDER, or SEGSIZE control and relocate. 

WARNING 55: UNDEFINABLE SYMBOL ADDRESS 
SEGMENT: segment name 
MODULE: module name 

Meaning 

A local symbol, line number, or public symbol has been found in the specified seg- 
ment that is addressed relative to the specified group's base address. However, the 
segment containing the symbol is not within the 64K frame of reference that is 
defined for that group. 

Cause 

This is usually the result of an address assignment error in the invocation line. 
Effect 

LOC86 continues processing with no other side effects. The print file and object files 
are valid. However, you cannot use the symbols contained in the specified segment. 

User Action 

Examine the invocation line and reinvoke LOC86. 



G-25 



LOC86 Controls and Error Messages 



iAPX 86,88 Family Utilities 



WARNING 56: SEGMENT IN RESERVE SPACE 
SEGMENT: segment name 

Cause 

Either an absolute segment uses the area reserved in the invocation line or you 
assigned an address to a segment or class that forces the specified segment to be 
located in the reserved area. 

Effect 

The specified segment is located in the reserved area, and LOC86 continues process- 
ing with no other side effects. Both the print file and object file are usable. 

User Action 

If the assigned address is acceptable for the segment, no action is necessary. 



ERROR 57: INVALID GROUP NAME 

ERROR IN COMMAND TAIL NEAR #: 
partial command tail. 

Meaning 

LOC86 was expecting a group name when it found a token that did not correspond 
to a valid group name. LOC86 repeats the invocation line up to the point of the 
error. 

Cause 

This is often caused by a typographical error in the invocation line. 
Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 



ERROR 58: SPECIFIED GROUP NOT FOUND IN INPUT MODULE 
GROUP: group name 

Cause 

This is often caused by a typographical error in the invocation line. 
Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line to LOC86 and the link map for the input module. 
Reinvoke LOC86 correctly. 
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ERROR 59: GROUP ADDRESS PREVIOUSLY SPECIFIED IN INPUT 
MODULE OR COMMAND LINE 
GROUP: group name 

Cause 

Either you gave a single group an address twice in the same ADDRESSES control or 
the group already had an address (due to a previous locate). 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and either use the previously assigned address or assign 
the group one address per ADDRESSES control. 



WARNING 60: REFERENCED LOCATION IS NOT WITHIN 32K OF 
SPECIFIED ADDRESS 
MODULE: module name 
REFERENCED LOCATION: 20-bit address 
FRAME OF REFERENCE: 20-bit address 

Meaning 

An 8089 self-relative reference is not within 32K bytes of its target address. 
Cause 

Either with the ORDER or ADDRESSES control you have separated the reference 
from its target or the 8089 segment is too large. 

Effect 

LOC86 leaves the invalid reference and continues processing with no other side 
effects. Both the print file and the object file will be valid. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 



ERROR 61 : OVERLAY ERROR 
Meaning 

An internal LOC86 error has occurred. 

User Action 

Contact Intel immediately. 
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WARNING 62: CS AND IP REGISTERS NOT INITIALIZED 
Meaning 

This warning occurs when INITCODE is specified and the input register initializa- 
tion record does not specify intialization of the 8086 code segment (CS) register and 
the 8086 instruction pointer (IP) register. 

Cause 

This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 

Effect 

The values of CS and IP at the beginning of program execution are completely 
dependent on the loader of your system. 

User Action 

Invoke LOC86 with the START control if desired. 

WARNING 63: SS AND SP REGISTERS NOT INITIALIZED 
Meaning 

The INITCODE control was specified, but the register initialization record does not 
contain information for initialization of stack segment (SS) and stack pointer (SP) 
records. 

Cause 

This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 

Effect 

The values of SS and SP at the beginning of program execution are entirely depen- 
dent on the loader of your system. 

User Action 

If you will need to use the stack, retranslate your code, then relink and relocate. 
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WARNING 64: DS REGISTER NOT INITIALIZED 
Meaning 

INITCODE was specified, but the data segment (DS) register initialization record is 
incomplete. 

Cause 

This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 

Effect 

The value of the CS register at program execution is entirely dependent on the 
system loader. 

User Action 

Correct your code if necessary, then reinvoke LINK86 and LOC86. 

WARNING 65: SEGMENT ORDER IN ORDER-CONTROL CANNOT BE 
MAINTAINED 
SEGMENT: segment name 

Meaning 

The ADDRESSES and ORDER control specifications for a segment are in conflict 
and/or the segment cannot be allocated space in accordance with the ORDER 
control. 

Effect 

The conflicting segment is allocated space after all other segments in the target 8086 
memory. 

User Action 

If desired, reinvoke LOC86, using the appropriate ADDRESSES and ORDER 
controls. 
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WARNING 66: START ADDRESS NOT SPECIFIED IN OUTPUT MODULE 
Meaning 

The CS (code segment) and IP (instruction pointer) registers are not initialized. 
Cause 

The input module does not have an explicit start address, and the START control 
was not specified. 

Effect 

The values of these registers upon initial program execution are entirely dependent 
on the loader. 

User Action 

Either reinvoke LOC86 using the START control or relink to include a main 
module. 
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The following are descriptions of all OH86 error arid warning messages. The 
description of each message has up to four parts: 

• Meaning — how to interpret the message 

• Cause — the usual reason for the error or warning condition 

• Effect— the state of OH86 and the object file(s) after the message is issued 

• User Action — what you can do to correct the condition 

Not all these parts are given for each message. However, parts excluded are self- 
explanatory. 

Error messages are always fatal, but warning messages are not. In the event of a 
warning, read the EFFECT of the warning carefully to determine whether the 

resulting code is valid. 

Error and warning messages are displayed at the console device. 



pathname, PREMATURE END-OF-FILE ENCOUNTERED 
Meaning 

OH86 has scanned the entire input file without finding the record that signals the 
end of the module. 

Cause 

There is a transcription error in the specified file. 
Effect 

OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 

User Action 

Return to the last step in the program development process that did not generate this 
error and relocate, relink, or even retranslate. 
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pathname, EXPECTED MODULE HEADER NOT FOUND 
Meaning 

The first record in the input file was not a module header record. 
Cause 

This is usually caused by specifying an input file that does not contain an 8086 object 
module. 

Effect 

OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 

User Action 

Check the invocation line; if you specified the input file incorrectly, then reinvoke 
OH86 more carefully. Otherwise, return to the last step in the program development 
process and reexecute. 

pathname, ILLEGAL RELOCATION RECORD ENCOUNTERED 
Cause 

This error occurs whenever you specify a non-absolute 8086 object module as the 
input file. 

Effect 

OH 86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 

User Action 

Locate the object module with LOC86 before reinvoking OH86. 



pathname, INSUFFICIENT MEMORY TO PROCESS DATA RECORD 
Meaning 

There is insufficient memory in your system for OH86 to process your input file. 
Cause 

You are trying to convert a file that is too complex for the available memory in your 
system. 

Effect 

OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 

User Action 

Expand the memory on your system. 
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pathname, ILLEGAL REGISTER INITIALIZATION RECORD ENCOUNTERED 
Cause 

Your input module contains a register initialization record. 
Effect 

OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 

User Action 

Relocate with INITCODE in effect. 

pathname, ILLEGAL OVERLAY INFORMATION ENCOUNTERED 
Cause 

You attempted to convert a file containing overlay information. 
Effect 

OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 

User Action 

If overlays are necessary, create root and overlay in separate files. 
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Environmental Considerations 

The iAPX 86,88 Family utilities run on and can be used to produce code executable 
on the Intellec Series III Microcomputer Development System. Resulting code is also 
compatible with the lCE-86 Emulator and DEBUG-86. 

The following conventions of the Series III operating system (ISIS-II) are 
encountered in running the utilities: 

• The utilities must be executed when the Series III is in the 8086 mode. This 

operating mode is activated by entering the RUN command, either in conjunc- 
tion with a utility program invocation or by itself (to enter the "interactive" 
8086 mode): 



RUN :F1:L0C86 : F3 : M Y PROG . LN K<c r> 



RUN<cr>i 

: F 1 : L 0 C 8 6 : F 3 : M Y P R 0 G . L N K < c r > 



The :Fn: portion of the pathname is the Series III directory-name. In this 
configuration, the directory-name is the equivalent of a device name, the device 
on which the filename is located. If the file is located on the system disk (:F0:), 
the directory-name may be omitted from the pathname. 

Continuation lines are necessary when a command or invocation will not fit on 
one line. The following example illustrates the line-end conventions to use and 
the continuation characters to expect: 



> 

>> 

> 



LINK86 :F3: TEST. OB J, SMALL. LIB, USER. LI 
TO :F3:TEST.86 BIND<cr>i 



B &<cr> 



• The L1B86 utility presents an exception to these prompt conventions. Because 
this program is interactive, it has its own prompts: 



LIB86<cr> 



SERIES-III 8086 LIBRARIAN Vx.y 



[ADD :F1 


: SEC. "LNK, 


F1 


CSC . LNK, 


8;<cr> 


Q: F1 :TAI 


A . LNK TO TF 


HG 


LIB<cr>i| 





The following table defines compatible software version combinations. 





ISIS-II 


ISIS-III(D) 
V1.0 or later 


V4.0 


V4.1 


V4.2 


RUN 




V1.0 
V1.1 


VI .0 
VI .1 

V1.2 


VI .3 
or later 


VI .2 


VI .3 
or later 


UNK86 




VI .0 


VI .0 


V2.0 
or later 


VI .0 


V2.0 
or later 


CREF86 




VI .0 or later 


LIB86 




VI .0 or later 


LOC86 




VI .0 or later 


OH86 




VI .0 or later 
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Related Publications 

The following manuals may be helpful during various aspects of your work with 
iAPX 86,88 utilities on the Series III: 

• Intellec Series III Microcomputer Development System Product Overview, 
order number 121575 

• iAPX 86, 88 User's Manual, order number 210201 

• Intellec Series III Microcomputer Development System Console Operating 
Instructions, order number 121609 

• Intellec Series III Microcomputer Development System Programmer's 
Reference Manual , order number 121618 

• PASCAL-86 User's Guide, order number 121539 

• PL/M-86 User's Guide , order number 1 2 1 636 

• ASM86 Language Reference Manual, order number 1 2 1 703 

• ASM86 Macro Assembler Operator's Manual, order number 1 2 1 628 

• 8089 Macro Assembler User's Guide , order number 9800938 

• FOR TRAN-86 User's Guide , order number 1 2 1 570 



Program Development Examples 

The following examples are programming problems solved by using one or more of 
the iAPX 86,88 utilities on the Series III to develop code for an 8086-based host. 

Example 1: Preparing to Use DEBUG-86 

There are only two steps to preparing your code for execution: translating the code, 
then linking it with BIND. 

First you must translate your code. Any of the 8086 translators will work. An 
example of one such translation is shown below: 



RUN PLM86 :F6:TEST.SRC DEBUG SMALL<cr> 



Once the program has been translated, you must then link the program with the 
BIND control. LINK86 with BIND produces an LTL module — the loader assigns 
addresses to the LTL modules at load time. This operation can be performed by the 
8086 loader, RUN. The operation and control of both of these programs is given in 
the Intellec Series III Microcomputer Development System Console Operating 
Instructions . 

The invocation line for LINK86 when linking the program shown above might 
appear as follows: 



>> 



RUN LINK86 : F6 : TEST . OB J , : F6 : UT I L S . 0 B J , 
: F6:SMALL. LIB TO :F6:TEST.86 BIND<cr>' 



In the above example note that all of the symbol information (LINES, SYMBOLS, 
PUBLICS) is left in the output object file. This will aid you while debugging your 
program. DEBUG-86 uses the symbol information to produce diagnostic informa- 
tion on the program. 

This information is also included in the symbol table. Figure I-l shows the print file 
from the invocation above. 
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The libraries specified resolve all of the external references in TEST.OBJ. 

After the above linkage, the program can be executed with the following command 
to the Series III: 



;UN DEBUG : F6 : TEST . 86<c r> 



S£iiIES-lIl 6Utlb LIMKEH, Vx./ 

INPUT FILES: :F6:TEST.0BJ, : F6 : UTILS . Ob J , : F6 : SMALL . LIB 
OUTPUT FILE: :F6:TEST.86 

CONTROLS SPECIFIED IN INVOCATION COHMANC : 
BIND 

DATE: MU/DDIYY TIME: 



LINK MAP OF NODULE ROOT 



LOGICAL SEGMENTS INCLUDED: 

LENGTH ADDRESS ALIGN SEGMENT 

0351H H CODE 

OOlilH U CONST 

0196H W DATA 

03F8H H STACK 

OOOOH H MEMORY 

OOOOH G ?TSEG 

INPUT MODULES INCLUDED: 
: F6: TEST. OBJ (RUCJT) 
:F6:UTILS.0& J (UTILITIES) 
: Fb : SHALL. LIB (DU ATTACH) 
:F6: SMALL. LIB(DQCLOS£) 
:F6: SHALL. LIB(DQCREAIE) 



CLASS 

CODE 

CONST 

DATA 

STACK 

MEMORY 




GROUP NAME: CGROUF 

OFFSET SEGMENT NAME 
OOOOH CODE 

GROUP NAME: DQROUP 

OFFSET SEGMENT NAME 



OOOOH 
0014H 
01AAH 
0SA2H 



CONST 
DATA 
STACK 
MEMORY 



SYMBOL TABLE OF MODULE ROOT 



BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


0(2) 


OUtH 


PUB 


BINDCONTROL 


Q(2) 


OOllAH 


PUB 


BNODEBASE 


0(2) 


0016H 


PUB 


BUFBASE 


G(2) 


00 IIH 


PUB 


BUFLEN 


0(2) 


Ob^CH 


PUB 


CLASHNODEBASE 


0(2) 


005EH 


PUB 


COCONN 


0(2) 


015ilH 


PUB 


COHMENTSCONTROL 


G(2) 


01 6FH 


PUB 


CURRENTOVERLAYNU 
M 


0(2) 


0171H 


PUB 


DEfiUGTOGGLE 


G(2) 


00A5U 


PUB 


DEFAULTPRTFILENA 














-HE 


NODULE 


NAME s 


ROOT 












BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


G(2) 


05A2fl 


SYM 


MEMORY 


G(2) 


OOOOH 


SYM 


COPYRIGHT 


G(2) 


0014H 


SYM 


BUFLEN 


G(2) 


0016H 


SYM 


BUFBASE 


0(1) 


00F7H 


SYM 


ERROR 


G(1 ) 


OOFEH 


SYM 


WARNING 


0(2} 


0016H 


SYM 


LASTNHNODEP 


0(2) 


OOlAfl 


SYM 


FIRSTNMNODEP 


0(2) 


001 CH 


SYM 


LASISGNODEP 


0(2) 


001EH 


SYM 


FIRSTSGNODEP 


G(2) 


0020H 


SYM 


LASTTDNODEP 


G(2) 


0022H 


SYM 


FIRSTTDNODEP 


0(2) 


OOStH 


SYM 


LASTEXNODEP 


G(2) 


0026H 


SYM 


FIRSTEXNODEP 



G(1 ) 


OOAbH 


LIN 


1t1 


G(1 ) 


00B3B 


LIN 


143 


G(1 ) 


OOBEh 


LIN 


It* 


Gd ) 


O0C8H 


LIN 


145 


G(1) 


OOCFH 


LIN 


146 


G(1 ) 


00D2H 


LIN 


14» 


G(1 ) 


OODDh 


LIN 


149 


G(1 ) 


00E7H 


LIN 


150 


G(1) 


OOEEH 


LIN 


152 


0(1) 


00F5H 


LIN 


153 



REFERENCES TO SEGMENT BASES EXIST IN INPUT MODULES: 
ROOT 



Figure I-l . LINK86 Print File for Bound Object Module 
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Although we do not recommend it, it is possible to execute an absolute object 
module with DEBUG-86. However, the module must be located in free user 
memory. DEBUG-86 uses the address from OFCOOOH to OFFFFFH, and RUN uses 
the address from OOH to 77FFH. All other memory is available. However, if your 
system does not have a full megabyte of memory, there may be other areas that must 
be reserved. You can use the RESERVE control to prevent LOC86 from using these 
areas. 

The following invocation line is an example of how :F6:TEST.86 might be located; 
although :F6:TEST.86 has been bound, programs that are to be located for execu- 
tion on the Series III need not be bound: 



>> 



RUN L0C86 :F6:TE $T.86 RE$ERVE(' 
TO OFFFFFH)<cr>" 



TO 77FF 



The print file produced from the above invocation is shown in figure 1-2. 



SERIES-III 80a6 LOCATER, Vx.y 

INPUT FILE: :F6:TEST.a6 
OUTPUT FILE: :Fb:TEST 

CONTROLS SPECIFIED Ih INVOCATIUH COMMAND: 

HESl£BVE(O0H TO 77FFH , OFCOOOH 10 OFFFFFH) 
DATE: MU/DD/YY TIME: 



SYMBOL TABLE Of MODOLE ROOT 



BASE 


Ot'FSET 


TKPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


07B8H 
07B8H 
07B8H 


OltCh 
O03'»H 
0 140H 


PUB 
PUB 
PUB 


BINDCONTROL 

CLASHN0DEBA3E 

COMMENTSCONTROL 


07BeH 
07B8h 
07BbH 


0032H 
001|6H 
0 157H 


PUB 
PUB 
PUB 


BNQDEBASE 
COCONN 

CURRENTOVERLAYNU 
-M 

DEFAULTPRTFILENA 
-ME 
FANODEBASE 
FBLOCKLISTHEAD 
FBLOCKSEQUENCENU 


07B8H 


0 159H 


PUB 


DEBUGTOGGLE 


07B8H 


OOBDH 


PUB 


07B8H 
07B8H 
07B8H 


0048H 
0054H 
0052H 


PUB 
PUB 
PUB 


EXCEPTION 

FBLOCKBASE 

FBLOCKLISTTAIL 


07BBH 
07B8H 
07B8H 


002EH 
0050H 
0123H 


PUB 
PUB 
PUB 



-MBER 




MEMORY MAP OF MODULE ROOT 

MODULE START ADDRESS PARAGRAPH = 081 1H OFFSET : 0006H 
SEGMENT MAP 



START 


STOP 


LENGTH 


ALIGN 


NAME 


CLASS 


07b00H 


07B7CH 


057DH 


M 


CODE 


CODE 


07B60H 


07B80H 


OOOOH 


M 


CONST 


CONST 


OTBbOH 


07D1 IH 


0192H 


M 


DATA 


DATA 


07D12H 


0b109H 


03FbU 


M 


STACK 


STACK 


OblOAH 


OblOAH 


OOOOH 


M 


MEMORY 


MEMOR 


QUI 10H 


0b12bH 


0019h 


G 


7?L0Cbb_lNlTC0 


CODE 










-DE 




OBI 30H 


Ob130H 


OOOOH 


Q 


77SEa 





GROUP MAP 



ADDRESS GROUP OR SEGMENT NAME 
07800H CGROUP 

CODE 
07B60H DGROUP 

CONST 

DATA 

STACK 

MEMORY 



Figure 1-2. LOC86 Print File for Bound Object Module 
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Example 2: Preparing to Use an ICE-86 System 

Another way to test and debug software is using in-circuit emulation (ICE) system. 
The ICE-86 loader can load only absolute object modules. Therefore, you cannot 
use the output from LINK86 immediately; it must be located too. 

The whole process of preparing a program for ICE-86 execution takes three steps. 
The first two are the same as in Example 1: the program must be translated and 
linked: 



iRUN PLM86 : F6: ICETST.SRC SMALL<cr> 



RUN LINK86 ;F6:ICET$T.0BJ,:F6:$MALL.LIB<cr> 



The above example shows a straightforward linkage with no change to the default 
control setting. Note that NOOVERLAY and NOBIND, the defaults, are set. The 
ICE-86 loader has no facility for dealing with overlay modules created by using the 
LINK86 OVERLAY control. In this case there are no unresolved external references 
in the object module. If the module did contain unresolved references, it could still 
be executed by the ICE-86 system. However, as with execution under DEBUG-86, 
executing instructions that contain unresolved references will produce undefined 
results. 

Figure 1-3 shows the print file produced during the invocation shown above. 
L1NK86 does not produce a symbol table with NOBIND is in effect. 

The last step before ICE-86 execution is transforming the relocatable object module 
into an absolute object module with LOC86. The invocation line shown below 
would produce an object file that could be loaded and executed by the ICE-86 
Emulator: 



RUN L0C86 : F6: ICETST. LNK<cr> 



SERIES-III 8086 LINKER, Vx.y 






INPUT FILES: :F6:ICETST.0BJ, :F6 


SHALL. LIB 




OUTPUT FILE: : P6 : ICETST . LNK 






CONTROLS SPECIFIED IN INVOCATION 


COMMAND: 




DATE: MM/DDIYY TIME: 






LINK MAP OF MODULE LOANER 






LOGICAL SEGMENTS INCLUDED: 






LENGTH ADDRESS ALIGN SEGMENT 


CLASS 


OVERLAY 




037DH W CODE 


CODE 






OOOOH U CONST 


CONST 






0192H W DATA 


DATA 






OSFbh W STACK 


STACK 






OOOOH W MEMORY 


MEMORY 






OOOOH G ??SEG 






INPUT MODULES INCLUDtD: 








F6 : ICETST. OB J (LOANER) 








F6 :SMALL.LIB(DQAITACH) 








F6 :SMALL.LIB(DQCLOSE) 








F6 : SMALL. LIB (DQCREATE) 








F6 : SMALL. LIB (DQDETACH) 








F6 :SMALL.LIB(DQEXIT) 








F6 :SMALL.LIB(DQGETSISTEM1D) 








F6 :SMALL.LIB(DQOPEN) 








F6 :SMALL.LIB(DQOVERLAY) 








F6 :SMALL.LIB(DQURITE) 








F6 :SMALL.LIB(SXST£MSTACK) 







Figure 1-3. LINK86 Default Print File 
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This invocation line shows LOC86 invoked with the default control setting. Note 
that the INITCODE control is in effect by default. 

The PL/M-86 program ICETST.SRC is ready for execution on an ICE-86 system. 

Examples: Using CREF86 

Figure 1-4 illustrates a CREF86 cross-reference listing for an input list of 15 files, 
one of which contains several modules. The output print file pathname OUT and a 
title for the listing were specified in the controls. Although PAGEWIDTH (PW) and 
PAGELENGTH (PL) specifications were also noted in the controls, the numbers 
specified are the same as those provided by default. 



CREF86 EXAMPLE OF CROSS REFERENCE USING CREF86 



SEBIES-III CHEF86 Vxy 



INPUT FILES: 



OUTPUT FILE: 
CONTROLS SPECIFIED: 



MODULES INCLUDEU: 



:F1 :STA1E.0BJ 
:F1:SCUTIL.0BJ 



:F1:R0OI.0BJ : F 1 : P AKSE . OBJ 

:F1 :MEMHAN.0BJ : F 1 : SCANNR . OB J 
:F1:S0RT.0BJ : F 1 : UDSHA .LNK 

OUT 

PR(OUT) TT(EXAHPLE OF CROSS REFERENCE USING CREFti6) PVi(120) PL(60) 



:F1 :SiaN0N.0BJ 
:F1 :PR0CES.OBJ 
COMPAC .LIB 



MM/DD/YY 



F1 lERROR.OBJ 
F1 rLIST.OBJ 



:F1 :UTILS.OBJ 
:F1 ILSUTIL.OBJ 



FILE NAME 


MODULE NAM£(S) 


:F1 


: BOOT. OBJ: 


CREF86 


:F1 


:PARSE.OBJ: 


PARSE 


:F1 


:SIGN0N.OBJ : 


SIGNON 


:F1 


STATE. OBJ : 


NEXTSTAIE 


:F1 


ERROR. OBJ: 


ERROR 


:F1 


UTILS.OBJ : 


UTILITIES 


:F1 


MEMMAN.OBJ : 


MEMORYMANAGEMENT 


:F1 


SCANNR. OBJ : 


SCANMODULES 


:F1 


PROCES.OBJ : 


PROCESSRECORDS 


:F1 


SCUTIL.OBJ : 


SCANUTILITIES 


:F1 


LIST. OBJ: 


LISTOUTPUT 


:F1 


LSUTIL.OBJ : 


LISTUTILITIES 


:F1 


SORT .OBJ : 


SYMBOLSORT 


:F1 


UDSMA.LNK: 


OEJMAN 


COMPAC. LIB: 


DQALLOCATE 






DQDETACH 






DQGETIIME 






SXSTEMSTACK 



CQATTACH 

DQEXIT 

DQOPEN 



DQCHANGEEXTENSION 

DQFREE 

DQREAD 



DQCREATE 

DQGETARGUMENT 

DQSEEK 



DQDECODEEXCEPTION 
DQGETSYSTEMID 
DQWRITE 



EXAMPLE OF CROSS REFERENCE USING CRkFt>6 



SYMBOL NAME SYMBOL TYPE 

ACCESS_PAGE UNKNOWN 

ALLOCATE UNKNOWN 

APPENDNODE PROCEDURE NEAR 

APPENDUDSHNODE PROCEDURE NEAR 

ARRAYBASE POINTER 

ATOI PROCEDURE WORD NEAR 

BTOX PROCEDURE WORD NEAR 

BUBBLESORTVARNAMES. . . . PROCEDURE NEAR 

BUMPLINECOUNT PROCEDURE NEAR 

CHECKHEADEH PHOCEDURE NEAR 

CHECKOVERLAY PROCEDURE NEAR 

CHECAVARTYpE PKfif-SDUHE BYTE NEAR 



DEFINING MODULE; REFERRING MODULE(S) 



OBJMAN 

OBJMAN 

UTILITIES 

UTILITIES 

SYMBOLSORT 

UTILITIES 



UTILITIES; 
SYMBOLSORT; 
LISTUTILITIES ; 

SCANUTIHTItS i 
SCANUTILITIES ; 
SCANUTILITIES; 



PARSE SCANMODULES 

LISTOUTPUT 

PARSE 

LISTUTILITIES 

LISTOUTPUT 

LISTOUTPUT 

SCANMODULES 
SCANMODULES 
PROLtSShECOKDS 



PROCESSRECORDS 



EXAMPLE OF CROSS REFERENCE USING CREF66 



UMLOAD.PAGE UNKNOWN 

VARAREAP POINTER 

VBLOCKLlSIhEADER WORD 

WARNING PROCEDURE NEAR 

WHITEDATA PROCEDURE NEAR 

WRITEINIILINEBUF PROCEDURE NEAR 

WRITELINE PROCEDURE NEAR 

WRITENEWLINE PROCEDURE NEAR 

WRITETOCOHMANDBUF .... PROCEDURE NEAR 

WRITETOFILE PROCEDURE NEAR 

ZERO WORD 



MEMORYMANAGEMENT ; 
PROCESSRECORDS; 

ERROR; 

LISTUTILITIES ; 
LISTUTILITIES; 
LISTUTILITIES ; 
LISTUTILITIES; 
PARSE 

LISTUTILITIES ; 
UTILITIES 



PROCESSRECORDS LISTOUTPUT SYMBOLSORT 
UTILITIES LISTOUTPUT SYMBOLSORT 

SCANMODULES PROCESSRECORDS 
ERROR UTILITIES LISTOUTPUT 
ERROR UTILITIES LISTOUTPUT 
LISTOUXPUI 

UTILITIES LISTOUTPUT 
ERROR LISTOUTPUT 



Figure 1-4. CREF86 Cross-Reference Listing 
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Example 4: Building and Using Library Files 



A library is a file that contains object modules. Libraries allow you to collect 
commonly used pieces of software into one file. The library file can be included in a 
L1NK86 invocation, and LINK86 will use the modules to resolve references. 



You can add the output from a translator, LINK86, or LOC86 to a library. The 
modules added may be relocatable or absolute; they can have unresolved references 
or be completely linked. 



Let's consider the following scenario — we have created six routines (SINE, 
COSINE, TANGENT, COSECANT, SECANT, and COTANGENT). We want to 
create a library file that will allow each routine to be linked to programs separately. 



The first step necessary to create the library is to translate each routine separately. If 
we were to put them in a single source module, the translator would translate them 
into one module with six public symbols. We could add this module to a library, but 
when we tried to link one of the routines into a program, all six would be included. 



Once the routines are translated, LIB86 can be used to create a library file and add 
modules. The LIST command is used to display the contents of the library and the 
publics contained within it. 



LIB86<c r> 



SERIES-III 8086 LIBRARIAN Vx.y 



CREATE TRIG . LIB<c r>| 
ADD : F1 -.SIN .OBJ , : F1 -.COS .OBJ TO TRIG.LIB<cr> 
LIST TRIG. LIB PUBLICS<cr>: 



:F0:TRI6.LIB 
SIN 

SINE 
COS 

COSINE 



ADD :F1:SEC.LNK, :F1:CSC.LNK, : F1 : COT . LJK , &<cr> 

: F1 :TAN . LNK TO TRIG . LIB<c r> 
LIST TRIG. LIB PUBLICS<cr> 



:FO:TRIG.LIB 
SIN 

SINE 
COS 

COSINE 
SEC 

SECANT 
CSC 

COSECANT 
COT 

COTANGENT 
TAN 

TANGENT 



EXIT<cr> 
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Example 5: Linking and Locating Programs with 
Overlays Using OVERLAY Control 

The easiest way to build an 8086 program that contain overlays is with LINK86's 
OVERLAY control. Overlay modules built with this control reside in the same file 
as the root. The operating system supplies routines that will load the overlays con- 
structed in this way. See Intellec Series III Microcomputer Development System 
Programmer's Reference. 



After the program modules that will constitute the root and its overlays are 
translated, each of the overlays and the root must be linked separately. Then the 
root and all of the overlays are linked together. 



The example below shows the first step toward linking overlays- 
modules that will constitute each overlay and the root separately: 



-linking all of the 



>> 



RUN LINK86 0V1 . OB J , 0V1 A . OB J , 0V1 B . OBJ &<cr> 
OVERLAYCOVERLAYI )<cr> 



>> 



RUN LINK86 0V2A . OB J , 0V2B . OBJ , 0V2C . OB J TO &<cr> 
0V2.LNK OVERLAY (0VERLAY2XC r> 



RUN 


LINKJ 


16 


0V3 .OE 


JJ , 0V3A . OBJ 


0VERLAY(0VERLAY3)<cr>| 




RUN 


LINK^ 


16 


0V4.0E 


5J , 0V4A .OBJ 


0VERLAY(0VERLAY4)<cr>| 



>> 



RUN LINK86 ROOT .OBJ, ROOTA. OBJ, ROOTB.O BJ, &<cr> 
SMALL. LIB OVERLAY(ROOT)<cr>| 



Notice that all of the modules, including the root, are linked with the OVERLAY 
and NOBIND controls. The overlay name for the root is not as critical as for the 
overlays, since the overlay name is used when calling the loader. 



Finally, the overlays and root must be linked together. Since any one of the files 
could be the root, LINK86 requires that for the final link the file containing the root 
must be first in the input list. During this final the OVERLAY control is not used: 



BRUN LINK86 ROOT.LNK, 0V1 
gOV4.LNK TO PR0G.86<xr>| 



LNK, 0V2.LNK, 0V3.LNK, &<cr> 



In the invocation, the optional BIND control is specified. The resulting object file is 
executable on a Series III. 



Figure 1-5 shows the LINK86 print file listing for the above invocation. 



There is nothing special about the invocation line to LOC86 when locating a file that 
contains overlays or that has been bound: 



BRUN L0C86 PROG. 86 RESERV E°(OH TO 77FFH, S<Cr> 
SOFCOOOH TO OFFFFFMXc r>^^^^^^^H|^^H| 



The RESERVE control prevents LOC86 from assigning memory addresses reserved 
for the operating system. Figure 1-6 illustrates the printout from this invocation. 
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S£hies-Ill bOeb LlliKbR, Vx.y 

INPUT FILbS: ROOI.LMK, OVI.LtiK, 0V2.LNK, 0V3.LNK, OVt.LMK 
OUTPUT FILE: P«OG,86 

COMTKOLS SPECIFIED IJI INVOCATION COMMAND: 
BIND 

DATE: MM/DD/YY TIME: 



LINK MAP OF MODULE ROOT 



LOGICAL SEUMENTS INCLUDED: 
LENGTH ADDRESS ALIGN SEGMENT 

3CE7H G CODE 

ODOOH G CONST 

2840H G DATA 



CLASS 
CODE 
CONST 
DATA 



OVERLAl 
ROOT 
ROOT 
FOOT 



INPUT MODULES INCLUDED: 

ROOT.LNK(ROOI) 

0V1 .LNK(PARSE) 

0V2.LNK(ILUDE) 

0V3.LNK(PICILUDE) 

0V4.LNK(FASTLOAD) 



GROUP NAP 



GROUP NAME: CGROUP 

OFFSET SEGMENT NAME 
OOOOH CODE\CODE\fiOOT 
jCEiJh C0DE\C0DE\PASS1 
SCEbH CODE\C0DE\PASS2 



SYMBOL TABLE OF MODULE ROOT 



BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYPJ 


SYMBOL 


G(2) 


251CH 


PUB 


ACTUAL 


G(2) 


OFODH 


PUB 


ASSUMEROOTCONTR 


G(2) 


0F22H 


PUB 


BASEFIXUPSEXIST 


G(2) 


QFOCh 


PUB 


-L 

BINDCONTKOL 


G(2) 


0D26H 


PUB 


bNODEID 


G(2) 


21IEAH 


PUB 


BUFEASE 


G(2) 


QD2&H 


PUB 


CLASHNODEID 


0(2) 


0D5AH 


PUB 


COCONN 


G(2) 


OFOOH 


PUB 


COHMENTSCONTROL 


G(2) 


0F50H 


PUB 


CURRENTFILNUM 


G(2) 


OF 1 AH 


PUB 


CURRENTOVERLAINU 


0(2) 


OFUEH 


PUB 


CURRENTRECINDEX 



OVERLAY 


NAME = 


ROOT 


, MODULE NAME = 


ROOT 








BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


0(2) 


J(A20H 


SYM 


MEMORY 


G(2) 


0002H 


SYM 


COPYRIGHT 


G(2) 


ODOOH 


SYM 


LASTNMNODEID 


G(2) 


0D02H 


SYM 


FIRSTNMNODEID 


G(2) 


ODOiJH 


SYM 


LASTSGNODEID 


G(2) 


OD06H 


SYM 


FIRSTSGNODEID 


G(2) 


ODO&H 


SYM 


LASTIDNODEID 


G(2) 


ODOAH 


SYM 


FIRSTTDNODEID 


G(2) 


ODOCH 


SYM 


LASTEXNODEID 


G(2) 


ODOEH 


SYM 


FIRSTEXNODEID 


G(2) 


0D10H 


SYM 


LASTQRNODEIO 


0(2) 


0D12H 


SYM 


FIRSTGRNODEID 


G(2) 


ODUH 


SYM 


LASTOVNODEID 


G(2) 


0D16H 


SYM 


FIRSTOVNOOEID 


Q(2) 


0D1&H 


SYM 


LASTGNODEIO 


G<2) 


0D1AH 


SIM 


FIRST6N0DEID 


OVERLAY 


NAME : 


ROOT 


MODULE NAME : 


LIT 








BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYP t; 


SYMBOL 


G(2) 


4A20H 


SYM 


MEMORY 


G(2) 


003CH 


BAS 


SGNOOE 


G(2) 


OF56H 


SYM 


LITBASE 


G(2) 


OFSSH 


SYM 


LITID 


G(2) 


0F56U 


BAS 


LITNODE 


G(2) 


0F5AH 


SYM 


FIRSTNODEIDS 


G(2) 


OFetH 


SYM 


FIRSTNODE 


G(2) 


0F8EH 


SYM 


CURRENTRECINDEX 


Q(2) 


0F96H 


SYM 


TEMPLATE 


G(2) 


0FB9H 


SYM 


II 


0(1) 


OieEH 


SYM 


GETLIT 


STACK 


0006H 


SYM 


INDEX 


STACK 


OOO'JH 


SYM 


I 


0(1) 


02O7H 


SYM 


SGLIT 



Figure 1-5. LINK86 Listing for Program with Overlays 
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SEfilhS-III 60bb LOCAlbh, l/'x.y 

INPUT FILE: PROG. 66 
ObTFUI FILE: PROQ 

CONTROLS SPECIFIED IN INVOCATION COMMAND: 
fi£S£RVE(OH TO 77FFU .OFCOOOH TO OFFFFlf'U) 
DATE: MM/DD/YY TIME: 



SYMBOL TABLE OF MODULE ROOT 



BASE 


OFFSET 


IXtl 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


103tH 


251CH 


PUB 


ACTUAL 


1034H 


OFODH 


PUB 


ASSUHEROOTCONTRO 
-L 


1 03tH 


0F22H 


PUB 


BASEFIXUPSEXIST 


1034H 


OFOCH 


PUB 


BINDCONTROL 


103tH 


0026H 


PUB 


BNODEID 




24EAH 


PUB 


BUFBASE 


103UH 


002eH 


PUB 


CLASHNOOEID 


103UH 


0D5AH 


PUB 


COCONN 


1034H 


OFOOH 


PUB 


COMMENTSCONTROL 


103tH 


0F50H 


PUB 


CURRENTFILNUM 


103tH 


OFIAh 


PU£ 


CURRENIOVERLAYNU 
-« 


1034H 


0F8EH 


PUB 


CURRENTRECINDEX 




OVERLAX 


= HOOT 


MODULE = ROOT 










BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


103tH 


ltA20H 


SYM 


MEMORY 


103tH 


0002H 


SYM 


COPYRIGHT 


103tH 


ODOOH 


SYM 


LASTNNNODEID 




0D02H 


SYM 


FIRSTNMNODEID 


103th 


ODOtH 


SYM 


LASTSGNODEID 


103tH 


ODO&H 


SYM 


FIRSTSGNODEID 


1031H 


0008H 


SYM 


LASTTDNODEID 


103tH 


OCOAH 


SYM 


FIRSTTDNODEID 


103'tH 


ODOCh 


SYM 


LASTEXNODEID 


103tH 


ODOEH 


SYM 


FIRSTEXNODEID 




0D10H 


SYM 


LASTGRNODEID 


103tH 


0D12H 


SYM 


FIRSTGRNODEID 


103tH 


0D14H 


SYM 


LASTOVNODEID 


103tH 


0D1&H 


SYM 


FIHSTOVNODEID 


1031H 


0D18U 


SYM 


LASTBNODEID 


103tH 


0D1AH 


SYM 


FIRSTBNODEID 


1034H 


0D1CH 


SYM 


SGNODEID 


103<tH 


001EH 


SYM 


GRNODEID 




















OVERLAI 


= HOOT 


, MODULE = LIT 










BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


1 03tH 


4A20H 


SYM 


MEMORY 


103tH 


003CH 


SYM 


SGNODE 


1 OStH 


OF56H 


SYM 


LITBASE 


lOStH 


0F58H 


SYM 


LITID 


1 03tH 


0F56H 


SYM 


LITNODE 




0F5Ah 


SIM 


FIRSTNODEIDS 


1 03tH 


0F64h 


SYM 


FIRSTNODE 


103ltH 


OFbEH 


SIM 


CUfiREhTlifcCINDEX 


1 034H 


OF96H 


SYM 


TEMPLATE 


103tH 


0FB9H 


SYM 


II 


OTBUh 


OIOEK 


SYM 


GETLIT 


STACK 


0006H 


SYM 


INDEX 


STACK 


0004H 


SYM 


I 


OTbOH 


0207H 


SYM 


SGLII 





MEMORY HAP OF MODULE ROOT 

MODULE START ADDRESS PARAGRAPH = UDbU OFFSET : 0006n 
SEGMENT HAP 



START 


STOP 


LENGTH 


ALIGN 


NAME 


CLASS 


OVERLAY 


07800H 


OB4E6H 


3CE7H 


H 


CODE 


CODE 


ROOT 


0B4E8H 


0F9BAH 


44D3H 


H 


CODE 


CODE 


PASS1 


OBtEBH 


OEOCEH 


2BE7H 


H 


CODE 


CODE 


PASS2 


OBIESH 


10337H 


4E50H 


N 


CODE 


CODE 


PIC_PASS2 



GROUP MAP 




ADDRESS 


GROUP OR SEGMENT NAME 


07800H 


CGROUP 




C0DE\CODE\R0OT 




C0DE\CODE\PASS1 




C0DE\CO0E\PASS2 




C0DE\CODE\PIC_PASS2 




CODE\CODE\FASTLOAD 


10340H 


DGROUP 




CONST\COHST\HOOT 




DATAXDATANROOT 




STACK\STACK\ 



Figure 1-6 LOC86 Listing for Program with Overlays 
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Example 6: Linking and Locating Programs witli Overlays 
Without OVERLAY Control 

It is harder to produce overlay modules without using the OVERLAY control. 
However, sometimes it is necessary to build programs in this way, for example, 
building a program for running under an operating system that does not support 
overlay modules contained in the same file as the root module. 

But regardless of the reason, building overlays in this fashion places an extra burden 
on the programmer. He must do some of the work that would be left to LINK86 
(and LOC86) if he were to use the OVERLAY control. In the following example we 
prepare a root and two overlay modules in separate files. 

First we must compile all modules. Examples of the invocation lines are shown 
below: 



iRUN PLM86 :F1:R00T.$RC $MALL<cr> 
^^^^^^^^^^^^^^^^^^ 



In the next step we must link the root module to resolve external symbols with a 
library and to obtain a link map: 



RUN LINK86 : F 1 : ROOT . OB J , US E R . L I B MAP<cr> 



We will need the link map for locating purposes. The link map, shown in figure 1-7, 
shows the size of each segment in the root. Since the overlays are self-contained 
except for references to the root, we do not need a link map for them. The PL/M-86 
listing files will show the size of each overlay's segments, as illustrated in figure 1-8. 

Note that the length of the root's code segment and OVl's code segment must fit 
within 64K. This means that the code for the overlays must be in a part of memory 
contiguous with the root (to avoid altering the CS register during execution). OV2's 
CONST and DATA segments are larger than OVl's so that the STACK segment 
must be placed to leave room for OV2's CONST and DATA segments. If the 
overlays share the STACK and MEMORY segments with the root, they must be 
located at the same address. 



SERieS-III aObb LINKER, Vx.y 

INPUT FILES: : F1 : ROOT . OBJ , USER .LIB 
OUTPUT FILE: :F1:R00T.LNK 

CONTROLS SPECIFIED IN INVOCATION COMMAND: 
MAP 

DATE: MU/DD/YY TIME: 



LINK HAP OF MODULE LOANER 



LOGICAL SEGMENTS INCLUDED: 

LENGTH ADDRESS ALIGN SEGMENT 

P49BH H CODE 

0381H W CONST 

0291H H DATA 

0030H W STACK 

OOOOU W HEHORI 



CLASS 

CODE 

CONST 

DATA 

STACK 

MEMORY 



INPUT MODULES INCLUDED: 
:F1 : ROOT. OBJ (ROOT) 
:fO:OSEH. Lie (LOADER) 
:F0 :USER.L1B(EXII ) 
:FO:USER.LIB(ERROR) 
:fO:US£R.LIB(TIME) 



Figure 1-7. LINK86 Map for Root File 
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0V1 • s 


segment 


size i n format i on 




MODULE INFORMATION: 












CODE AREA SIZE 
CONSTANT AREA SIZE = 
VARIABLE AREA SIZE = 
MAXIMUM STACK SIZE = 
918 LINES READ 
0 PROGRAM ERROR(S) 


7 53 1 H 
0081 H 
0181H 
0040H 


30001 D 
1 29D 
385D 
640 


this 
this 
this 
this 


is the 
is the 
is the 
is the 


CODE segment 
CONST segment 
DATA segment 
STACK segment 


END OF PL/M-86 COMPILATION 













0V2's segment size i n format i on 



MODULE INFORMATION 

CODE AREA SIZE = 1B9AH 7066D this is the CODE segment 

CONSTANT AREA SIZE = 0101H 257D this is the CONST segment 

VARIABLE AREA SIZE = 0454H 1108D this is the DATA segment 

MAXIMUM STACK SIZE = 0067H 103D this is the STACK segment 
918 LINES READ 
0 PROGRAM ERROR(S) 

END OF PL/M-86 COMPILATION 



Figure 1-8. Module Information for Overlays 



After computing the required location for the root's DGROUP and STACK, we can 
locate the root module. The resulting file will not be executable, but it allows us to 
resolve references to the root's code and data symbols in the overlays. The following 
LOC86 invocation will leave room for the overlays' code segments and place the 
DGROUP in the first unused memory location. (In the command line below, the DS 
register is initialized to OFFCEH, and the CS register is initialized to 0.) The STACK 
and MEMORY segments will be located above OV2's DATA segment: 



>> 
>> 
>> 
>> 



RUN L0C86 : F1 :ROOT. LNK &<cr>^ 
ADDRESSES(GROUPS(C6ROUP(0H),DGROUP(0FFCEH)), &<cr> 

SEGMENTS (CODE (OH) , CONST (OFFCEH) , STACK (1 0B34H) ) ) &<cr> 
0RDER(SE6MENTS (CODE, CONST, DATA, STACK, MEMORY) ) &<cr>, 
SEGSIZE(STACK(100H)) <cr>i 



Once the root is located, we can use it to resolve external references in the overlay 
modules. The overlay modules cannot call each other, since only one is resident in 
memory at any time. The link commands are shown below. The NOPUBLICS with 
the EXCEPT control is used to avoid conflicts when we use the located overlays to 
resolve external references in the root: 



BRUN LINK86 :F1 :0V1 .0BJ,PUBLICS0NLY(:F1 : ROOT) S<cr> 
gNOPUBLICS EXCEPT (0V1 CODE, 0V1 DAT AXc r>^^^^^M 



[RUN LINK86 
gNOPU^LICS 



:F1:OV2.0BJ,PUBLICSONLY(:F1: ROOT) S<cr>| 
EXCEPT (0V2C0DE . OVZDATAX'c r>^HHI|[^H 



The PUBLICSONLY control resolves references to public symbols contained in the 
root. 
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After the overlays have been linked, they must be located. The code and data 
segments must be placed in the memory locations that were reserved when we first 
located the root. In this case the STACK and MEMORY segments must be the same 
for the overlays and the root: 



> 

>> 
>> 
>> 



RUN L0C86 : F1 :0V1 . LNK &<c r>, 
ADDRESSES(GROUPS(CGROUP(0H),D6ROUP(0FFCEH)), &<cr> 

SEGMENTS(CODE(8A9CH),CONST(105E0H) , S m K m B34 H )JJ &<c r> 
O.RDER (SEGMENTS (CODE, CONST, STACK, MEMORY) )■ &<cr> 
SEGSIZE(STACK(100H))<cr> 



> 

>> 
>> 
>> 



RUN L0C86 : F1 :0V2. LNK &<c r> 
ADDRESSES (GROUPS (CGROUP( OH) ,DGROUP(.0FFCEH) ) , &<cr> 

SEGMENTS ( CODE (8A9CH) , CONST (105E0H) , STACK (10B34H))) &<cr> 
ORDER (SEGMENTS (CODE, CONSLlDATA, STACK, MEMORY) ) &<c r> 
SEGSIZE(STACK(1 OOH) )<cr>' 



The CGROUP and DGROUP base address must be specified in order to compute 
offset information. The final base address assigned to DGROUP by LOC86 will be 
rounded up to OFFDOH. 



Once the overlays are located, the root is linked and located into an executable form. 
The PUBLICSONLY control will resolve references to symbols in the overlay 
modules. Other than the addition of this input control, the LINK86 and LOC86 

command must be identical to those used previously: 



>> 



RUN LINK86 : F 1 : ROOT . 0 B J , USER . L I B , &<cr> 
PUBLICSONLY(: F1 :0V1 , :F1 :0V2)<cr>! 



> 

>> 
>> 
>> 



RUN L0C86 :F1 :ROOT.LNK &<cr> 
ADDRESSES(GROUPS(CGROUP(OH),DGROUP(0FFCEH)), &<cr> 

SE6MENTS(CODE(0H),CONST(0FFCEH),STACK(10B34H)J) ^<c^ 
0RDER(SE6MENTS(C0DE, CONST, DATA, STACK, MEMORY)) S<cr> 
SEGSIZE(STACK(100H) )<cr>| 



The executable forms of the root and its overlay files are contained in :Fl:ROOT, 
:Fl:,OVl, and :Fl:OV2. Figure 1-9 shows the resulting layout of memory. 



ROOT CODE 
SPACE 



OVERLAY 
CODE 
SPACE 



ROOT DATA 
SPACE 



OVERLAY 
DATA 
SPACE 



STACK AREA 



MEMORY 



8A9B 
8A9C 



OFFCO 
OFFCE 



105DF 
105E0 



10B33 
10B34 



10C33 
10C34- 



-DS.SS 



Figure 1-9. Memory Organization for Example 6 
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Example 7: Linking 8089 Programs witii 8086 Programs 

The process of linking and locating 8086 programs with 8089 programs that use 8089 
local memory is very similar to creating overlay modules in separate files. 

Let us consider the following example: we have created an 8086 program and two 
8089 program modules. The 8089 programs reference each other's symbols and 
public symbols in the 8086 program. In addition, one of the 8089 programs must be 
resident in 8089 local memory. 

The first step is to translate the programs. The 8089 program modules must be 
translated separately, since they will be located in different 8089 address spaces. The 
following lines illustrate the invocation lines to the translators: 



RUN ASM86 : F1 : PR0G86 . A86<c r> 



IASM89 


: F1 


:TASK1 , 


. A89<c r>| 




IASM89 


: F1 


:TASK2 , 


. A89<cr>| 



TASK2 should be linked and located first for 8089 local memory. This linkage will 
leave unresolved external references, but it is needed to resolve the references in 
TASK I: 



RUN LINK86 : F1 : TASK2 . OB J , 8089 . LIB<c r> 



RUN L0C86 : F1 :TASK2 . LNK RESERVE (1 0000 



TO OFFFFFH)<cr> 



The RESERVE control in the locate above is a precaution to avoid exceeding 64K. 

The next step is to link and locate the object modules that will reside in the 8086 's 
address space. The external references to the 8089 program module that is resident in 
8089 local memory are resolved with the PUBLICSONLY control. The invocation 
lines for linking and locating the modules are: 



>> 
>> 



RUN LINK86 :F1 :PR0G86.0BJ , S<cr> 
8086.LIB,:F1 :TASK1 .OBi,8089.LIB, &<cr> 
PUBLICSGNLY( ; F1 :TASK2) TO : F 1 : 86N89 . LN K<c r> 



RUN L0C86 : F1 :86N89 . LNK<cr> 



:F1:86N89 contains an absolute object module that includes PROG86 and TASKl. 
It may be loaded and executed on an 8086-based system. However, the 8089 pro- 
gram to be located in 8089 local memory still has some unresolved external 
references. To resolve those references we must relink with PUBLICSONLY and 
relocate. The invocation lines to LINK86 and LOC86 shown below are identical to 
those used earlier. This is necessary to guarantee that the references resolved earlier 
are not invalidated: 



>> 



RUN LINK86 :F1 :TASK2,.0BJ ,8089. LIB, &<cr> 
PUBLICS0NLY(:F1 :86N89)<cr> 



RUN L0C86 : F1 :TASK2 . LNK RES ERVE (1 OOOOH TO OFFFFFH)<cr> 



NOTE 

The example above makes many assumptions about the 8089 and 8086 code 
that it deals with. In most practical situations it is usually necessary to use a 
more complex LINK86 and LOC86 invocation. However, the example 
above illustrates the key linking and locating principles underlying 
ASM86/ASM89 module combination. 
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Invocation Examples 



The following foldout pages contain examples of the iAPX 86,88 Family utility con- 
trols and commands. The examples, all in the "interactive 8086" mode, may be used 
in conjunction with syntax specifications given: 

• In Chapter 2 for LINK86 



• In Chapter 4 for LIB86 

• In Chapter 5 for LOC86 

When using the directions in these chapters, fold out the page in this appendix con- 
taining examples of the command or control you are interested in. 

The following is a sample Series III OH86 invocation: 



In Chapter 3 for CREF86 



> 
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Comments 

This example defines two public symbols, VARONE 
and VARTWO, with absolute addresses 50H and 
2000H, respectively. 

In this example the root file is RTFILE and LIB1 and 
LIB2 are library files. 



This line creates an LTL module. The output object 
file is TEST with no extension. 

This example specifies default to avoid ambiguity. 



LINES is the default, so it need not be specified. 



This MEMPOOL example will increase the minimum 
dynamic memory requirements by 20H bytes, and by 
default the maximum size will increase, if necessary, 
to equal the minimum. 

The minimum dynamic memory requirement is 100H. 
The maximum dynamic memory requirement is 
300 H. 



Control 



ASSIGN 



ASSUMEROOT 



BIND/NOBIND 



> 

>> 



SERIES III LINK86 EXAMPLES 
Examples 



LINK86 FILE1, FILE2, FILE3 ASSIGN &<cr> 
(VARONE (50H) , VARTWO (2000 ) )<c r>| 



> 

>> 



LINK86 R00T1.0BJ, R00T2.0BJ, LIB1, & <cr > 
LIB2 TO RTFI LE OVERLAY<c r> 



> 

>> 
>> 



LINK86 0V11.0BJ, 0V12.0BJ, LIB1, J<cr> 
LIB2 TO 0V1 .OBJ OVERLAY &<cr> 
ASSUMEROOT(RTFILE)<cr> 



> 

>> 
>> 



LINK86 0V21.0BJ, 0V22.0BJ, LIB;i,_S<cr> 
LIB2 TO 0V2.0BJ OVERLAY &<cr> 
ASSUMEROOT(RTFILE)<cr>l 



> 

>> 



LINK86 RTFIL E, 0V1.0BJ, 0V2.0BJ &<cr > 
TO PROG<cr> 



LINK86 TEST. OBJ, USER. LIB BIND PRINT<cr> 



COMMENTS/NOCOMMENTS 

FASTLOAD/NOFASTLOAD 

INITCODE 
LINES/NOLINES 

MAP/NOMAP 
MEMPOOL 



LINK86 GEN. OBJ NOBIND<cr> 



LINK86 : F1 rSOURCE.OBJ NOCOMMENTS <cr> 



> 

>> 



LINK86 : F1 :PROG.OBJ TO &<cr> 
: F1 -.TEMP.TST COMMENTS <c r>^ 



[LINK86 PROG.O 


BJ , LIB1 , LIB2 BIND S<c r>| 


BfASTL0AD<c r> 





LINK86 : F1 :MYPROG INITCODE<cr> 



LINK86 : F1 :RUN.OBJ NOLINES<cr> 



LINK86 : F1 rTEST.OBJ LINES<cr> 



LINK86 : F1 :TESTER.OBJ MAP<cr> 



> 

>> 



LINK86.86 : F3 : MA I N . OB J , US ER . OB J , &<cr> 
PUBLICSONLY( : F2:8089. LOO NOMAP<cr> 



> 

>> 



LINK86 :F1 rTEST.OBJ , USER. LIB, &<cr> 
PASCAL. LIB BIND M EM P 0 0 L ( + 2 0 H X c r>' 



> 

>> 



LINK86 : F1 -.TESTED .OBJ MEMPOOL &<cr> 
(100H,+200H) BIND<cr> 
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Comments 

The LINK86 output module will have the name 
specified in parentheses in the control. 



This example removes all debug and public records 
from the object file. 

The EXCEPT in the NOPUBLICS overrides the 
PURGE. 



This use of ORDER specifies the order of segments 
for two groups. 



This example will create an overlay record, and the 
name of the overlay wil be 0VERLAY1 . 



First the constituent files must be linked to form 
overlays. 



The print file is :F1 :TEMP1 .IVIP1 . 



The printfile is :F1:PR0G.MP1. 
The print file is :F1:THE. MAP. 



This example removes information about line 
numbers, local symbols, and comments from the 
print file. 

This statement removes all but the segment informa- 
tion and error messages from the print file. 



Control 

NAME 



OBJECTCONTROLS 



ORDER 



OVERLAY/NOOVERLAY 



PRINT/NOPRINT 



PRINT CONTROLS 



SERIES III LINK86 EXAMPLES 
Examples 



1LINK86 : F1 :TOM. OBJ , SYS . LIB NAME &<cr>H| 
HdHIS IS A VERY LONG_MODULEaNAME . )<c r>^ 



1LINK86 : F1 : SRC1 . OBJ , : F1 :SRC2.0BJ , S<cr> 
B: F3 -.USER . LIB NAMECTEST 5.3)<cr>|HiH 



1INK86 : F3 : PASCL1 .OBJ a<cr>H^|H| 
gOB J ECT CONTROLS (PURGE, NOPUBLICS S <cr>| 
gEXCEPT (START , DATA1, DAT A2) )<c r>BB| 



1LINK86 FILE4, FILE5, FILE6 TO &<cr>| 
a:F1 :0V2. LNK OV ER LAY (OVER LAY2)<c r>^ 



LINK86 :F1:R00T. 


LNK, : F1 :0V1 . LNK, &<cr> 


a 


:F1 :0V2.LNK<cr> 





LINK86 :F2:TEMP.0BJ &<cr> 
JBIND PRINTCONTROLS (NOLINES 
gNO COMMENTS, NO SYMBOLS )<cr> 
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Comments 

Public information concerning only DATA1, DATA2, 
LABELS, and PR0C4 is placed in the object file and 
print file. 

All public symbol information will be included in both 
the print file and output file. 

This example will produce a file containing only the 
absolute public symbol records from :F1 -.8089. LOG. 
The object file will be :F1 :8089.LNK. 

This will resolve the references in ROOT. OBJ to 
absolute public symbols in the separately linked and 
located overlays 0V1 and 0V2. 

This produces an object file containing no debug or 
public information. 

This confirms that the line and symbol information 
should be kept in the print file. 

This will change the translator-assigned name 
CGROUP to THE@CODE. A subsequent linkage 
would not combine THE@CODE with a group named 
CGROUP. 

This changes the name of the CODE group to 
CGROUP. 

This tells the loader that 15FFH bytes of code is the 
minimum requirement for MEMORY. The new max- 
imum size of MEMORY is 35FFH. 

This increments MEMORY'S minimum size by 1FFH 
{7951D) bytes. The maximum size of MEMORY is 
equal to the old minimum size plus 3FEH (15902D). 

The local symbol records will be included in the 
object file. 

PURGE is a shorthand for NOSYMBOLS, 
NOCOMMENTS, NOPUBLICS, NOTYPE, and 
NOLINES. 

SYMBOLCOLUMNS has no effect, since BIND was 
not specified. 

The symbol table will be printed on a line printer. 



LIBMOD will retain its type information. 



SERIES III LIN K86 EXAMPLES 



Control 

PUBLICS/NOPUBLICS 



PUBLICSONLY 



Examples 



LINK86 : F1 :TEST. OBJ , USER . LIB &<cr> 
NOPUBLICS EXCEPT( DATA1 , DATA2, &< cr> 
LABEL3, PR0C4)<cr> 



> 

>> 



LINK86 :F4:TEMP.0BJ, S MALL. LIB, S< cr> 
USER. LIB PUBLICS<cr> 



LINK86 PUBLICS0NLY(:F1 :8089.LOC)<cr> 



> 

>> 



LINK86 : F1 iROOT.OBJ , &<cr> 
PUBLICS0NLY(:F1:0V1,:F1:0V2)<cr> 



PURGE/NOPURGE 



LINK86 : F1 : INDEX. OBJ PURGE<cr> 



RENAMEGROUPS 



> 

>> 



LINK86 : F3 : FINAL. OBJ PR I NTCONTRO LS &<cr> 
(NOPURGE) <c r>i 



> 

>> 



LINK86 : F1 iPLMPRG.OBJ RENAMEGROUPS &<cr> 
(CGROUP TO THEaCODE)<cr> 



SEGSIZE 



> 

>> 



LINK86 : F9 : ASMPRG . OBJ &<cr> 
RENAMEGROUPS (CODE TO CGROUP)<cr> 



> 

>> 
>> 



LINK86 :F7:GE0RGE.0BJ, USER. LIB, S<cr> 
SYSTEM. LIB BIND S E G S I Z E ( M E MO R Y &<cr> 
(1 5FFH,+2 0 0 0 H) )<cr> 



> 

>> 



LINK86 : F4 : PROJ CT . OBJ , &<cr>; 
REST. LIB SEGSIZE(MEM0RY(+1FF,+1FF))<cr> 



SYMBOLS/NOSYMBOLS 



> 

>> 



LINK86 iFI :TEMP. OBJ, USER. LIB &<cr> 
NOSYMBOLS SYMBOLS<cr>l 



LINK86 :F3:TEST. OBJ, USER. LIB PURGE<cr> 



SYMBOLCOLUMNS 



LINK86 :F1:TEST.0BJ SYMBOLCOLUMNS (1 )<c r> 



> 

>> 
>> 



LINK86 :F1 rROOT.LNK, :F1 :0V1 .LNK, &<cr> 
:F1:OV2.LNK,PUBLICSONLY(:F3:8089) &<cr> 
SYMBOLCOLUMNS (4) BIND P R I N T ( : LP : )<c r>, 



TYPE/NOTYPE 



LINK86 : F1 : LIBMOD. OBJ TYPE<cr> 
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Comments 

The cross-reference listing will have 35 lines on each 
page. 

The cross-reference listing will be 100 characters 
wide maximum per page. 

The pathname of the print file will be :F1 ilVIYFILE. 



The message in the TITLE control must be placed on 
one line. If the message contains special characters, 
it must be enclosed in single quotes ('). 



SERIES III CREF86 EXAMPLES 



Control Examples 

PAGELENGTH > 

> 

PAGEWIDTH > 

> 

PRINT > 

> 

TITLE > 

> 
> 
> 



CREF86 :F1 :FILE1 , FILE 
gPAGELENGTH (35)<c r> — 



LIB &<cr> 



CREF86 : F1 : PROG , : F1 
BPAGEWIDTH (1 OOXc r>| 



LIB(MODI) S<cr> 



CREF86 :F2 
Hp R I N T ( : F 1 



FI LES (M0DULE1 
MYFILE)<cr>B 



M0DULE2) &<cr> 



CREF86 MYPR0G,HISPR0G,HERPR0G, S<c 
JMYLIB, HISLIB, HERLIB TllLE & <: r>B| 
JCA CROSS-REFERENCEJ)&<cr>BB|« 
] P A G E W I D T H (1 0 5 )< c r > ■■■■■^^H 
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Comments 

Three object files are added to the USER. LIB. 



Three modules from the library LIB. ABC are added 
to:F3:PROJ.TOM. 



This command will produce an empty library file 
called TOMS. LIB. 



Four modules are deleted from the library USER. LIB. 



SERIES III LIB86 EXAMPLES 
Examples 



ADD :F1:SIN,:F1:C0S,:F1:TAN TO &<cr> 
: FO:USER. LIB<cr> 



ADD : F1 : LIB. ABC (M0D1 , M0D2, M0D3) S< cr> 
TO : F3 :PROJ .TOM<cr> 



CREATE :F3:T0MS. LIB<cr> 



CREATE :FO:USER. LIB<cr> 



DELETE :F3:USER. LIB(TEMP1 , J<cr> 
TEMP3, TEM TMP , T E S T ^ )<c r>| 



DELETE :F0:IO.LI 


BCFLOPPY, CRT, &<cr>| 


HPAPER_TAPE)<c r> 





EXIT<cr> 



LIST USER. LIB<cr> 



USER. LIB 
TEMP 
TEST 
EXEC 
MAIN 
LOOP 



LIST USER. LIB(TEMP,TEST)<cr> 



USER. LIB 

TEMP 
TEST 



LIST USER. LIB, TEMP. LIB<cr> 



USER. LIB 
TEMP 

TEST 
EXEC 
MAIN 
LOOP 
TEMP. LIB 
M0DULE1 
M0DULE3 
MODULETC 
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Comments 



If SEG1 is byte alignable, it will be located at15FFH. 
If SEG2 is byte or word alignable, it will be at 4F5AH. 



Address assignment of groups, segments, and 
classes can be in any order, unless they are 
absolute. 



A long jump to GO will be placed at location 
OFFFFOH. 



The initialization code is placed at address 32768 
decimal (8000H). 

No initialization code will be produced. 



LINES is the default, so it need not be specified. 



This statement removes all debug records from the 
object file, but keeps the information in the print file. 



NOPUBLICS is implied by PURGE, but PUBLICS 
overrides it. 

SEG@A of CLASS1 will be the first relocatable 
segment located. SEG@B will be next, followed 
immediately by any other segments contained within 
CLASS1. The extra segments in CLASS1 (and all of 
the segments in CLASS2) are located in the order in 
which they are encountered. Finally, the list in the 
SEGMENTS subcontrol is handled. 



SERIES III LOC86 EXAMPLES 



Control Examples 



ADDRESSES > 

> 
> 

> 
> 
> 

BOOTSTRAP > 

> 

COMMENTS/NOCOMMENTS >| 

>| 

INITCODE/NOINITCODE >| 

>| 

LINES/NOLINES >| 

>| 

MAP/NOMAP >| 



NAME >| 

> 

OBJECTCONTROLS > 

> 
> 



L0C86 : F3 :PASCL1 . LNK a<cr>^^^|H 

Bob J ECT CONTROLS (PURGE, PUB LI CS)<cr>i 



L0C86 : FO :SPCSEQ. LNK ORDER &<cr>^H 
a(CLASSES(CLASS1(SEGSA,SEGaB), &<cr> 
3CLASS2) , SEGMENTS (SEG1 \CLASS3 &<cr> 
a\0VERLAY1 , SEG22. SEG1 0\CLASS5) )<c r> 



I 



L0C86 :F7:C0ME.LNK TO :F8:WENT &<cr>H 
aADDRESSES(SEGMENTS(SEG1 \CLASS2\ & <c r>l 
]0VERLAY3(15FFH) , SEG2 (4 F5AH ) )<c r>MB 



L0C86 :F8:IST.LNK TO LOCIST.RDY &<cr>^B 
^ADDRESSES (SEGMENTS (SEG1 \ C LAS SI &<cr>H 

S(23H)), GROUPS(C6ROUP(0OH) ,DGROUP &<cr> 
8(1 0 000 H) ) . C LASSES (MEMORY (1 5000 H) ) )<cr> 



L0C86 ; 


; F4: 


:SHORT. 


LNK 


NAME S<cr>^^^HH 


g(THIS 


IS 


A VERY 


LOh 


JG:MODULEaNAME.)<cr> 



L0C86 : F1 : UPWARD. LNKT<cr>^BH 

aOBJ ECTCONTROLS (NOLINES, S <c r>| 
]nocomments, NOSYMBOLSXc r>M^ 
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Comments 

The print file is :F1:TEMP.MP2. 



Tlie print file is :F5:INTERPL.MP2. 

The print file is :F1:MAP. 

Information about line numbers is removed from the 
print file. 

All but the segment information is removed from the 
print file. 

No public information is included in the output files 
(:F7:PRIVAT.MP2and :F7:PRIVAT). 

All public symbol information will be included in both 
the print file and output file. 

The object file contains no public or debug informa- 
tion, and the symbol table does not appear in the 
print file. 

The line and symbol information will be kept in the 
print file and object file. 

This control reserves the high order 64K of memory. 



A 200H and a 100H section of memory at the top and 
bottom of memory are reserved. 

The size of segment MEMORY will be increased by 
2000 bytes. 

The size of segment FREUD will be decreased by 
511 bytes. 

The new segment size for XENDA is 7770 bytes. 



:F9:AUT0 will start at IGNITION. 

:F7:HALTS will start at location 200H. 

This statement will include the local symbol records 
in the object file and the symbol information in the 
print file. 

PURGE is a shorthand for NOSYMBOLS, 
NOCOMMENTS, NOPUBLICS, and NOLINES. 



The symbol table will be printed on a line printer. A 
line printer line can hold a four-column symbol table. 



Control 



PRINT/NOPRINT 



PRINTCONTROLS 



PUBLICS/NOPUBLICS 



SERIES III LOC86 EXAMPLES 
Examples 



> 

>> 



L0C86 :F1 :PROG. LNK TO &<cr> 
,:F1 -.TEMPI .TST PRINT<cr> " 



L0C86 : F5: INTERP. LNK<cr> 



L0C86 :F4:PR0G.LNK PR I NT ( : F1 : MAPXc r> 



> 

>> 



L0C86 : F1 -.LINEAR . LNK &<c r> 
PRINTCONTROLS (NOLINESXc r> 



> 

>> 



L0C86 :F3:PR0G.LNK PRINTCONTROLS &<cr> 
(PURGE)<cr>' 



L0C86 :F7:PRIVAT. LNK NOP UB L I C S <c r> 



PURGE/NOPURGE 



> 

>> 



L0C86 :F9:TEXT.LNK NOPUBLICS &<cr> 
PUBLICS<cr> 



L0C86 : F3 :PR0J5 . LNK PURGE<cr> 



RESERVE 



SEGSIZE 



START 



SYMBOLS/NOSYMBOLS 



> 

>> 



L0C86 :F5:B0209.LNK PURGE &<^r> 
PRINTCONTROLS (N0PURGE)<cr> " 



> 

>> 



L0C86 : F3 : LOWMEM. LNK RESE RVE & <cr> 
(OFOOOOH TO OFFFFFH)<cr>| 



> 

>> 



L0C86 : F2-.HU60S . LNK RESERVE &<cr> 
(OOH TO 0200H, OFFFOOH TO OFFFFFH)<cr> 



> 

>> 



L0C86 :F6:GR0W.LNK SEGSIZE &<cr> 
"(MEMORY ( + 2000 ) )<cr>| 



> 

>> 



L0C86 :F1: SHRINK. LNK SEGSIZE &<cr> 
(FREUD(-1 FFH) ) <c r> 



> 

>> 
> 

> 
> 



L0C86 :F1 rRPLACE. LNK SEGSIZE &<cr> 
(XENDA(7770))<cr> 



LOC? 


16 


:F9; 


:AUTO.LNK STARTdGf 


nTION)<cr>i 




LOC{ 


16 


: F7: 


iHALTS.LNK START(0( 


)H,200H)<cr>| 



L0C86 GESHTA.LNK SYMBOLS<cr> 



SYMBOLCOLUMNS 



L0C86 :F3:TEST.LNK PURGE<cr> 



L0C86 :F1:TEST.LNK SYMBOLCOLUMNS (1 )<c r> 



> 

>> 



L0C86 :F5:LINKED.LNK &<cr>i 
SYMBOLCOLUMNS (4) PR I NT ( : LP : )<c r> 
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Environmental Considerations 



The iAPX 86,88 Family utilities run on and can be used to produce code executable 
on the iRMX 86-based systems. Resulting code is also compatible with the ICE-86 
Emulator and the iSBC 957B Interface and Execution Package. 



To run the utilities on an iRMX 86-based system, you must have the following hard- 
ware and software: 



• The iRMX 86 Human Interface (and other iRMX 86 layers necessary to support 
the Human Interface). 



• At least one mass storage device. The installation of the utilities always requires 
a single- or double-density diskette drive, since the product is delivered in 
diskette form. 



• Enough memory to run the utilities (above and beyond that required for the 
Operating System). Table J-1 lists the memory requirements for the individual 
utilities. The minimum required column indicates the minimum amount of 
memory needed to run the utilities, assuming connection to only six files. The 
maximum usable column indicates the largest amount of memory the utilities 
can use. 



Table J-1 . iRMX 86 Memory Requirements 



Utility 


IMinimum Required 


IMaximum Usable 


LINK86 


105K 


51 2K 


CREF86 


129K 


51 2K 


LIB86 


128K 


51 2K 


LOC86 


120K 


120K 


OH86 


90K 


goK 



When you run the utilities on an iRMX 86-based system, you must obey the follow- 
ing conventions: 



• To invoke a utility, you must enter the pathname of the file that contains the 
utility. An example of this is: 



:PR0G:L0C86 : F DO : P ROG D I R / M Y P RO G R AM . LN K <cr> 
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• The portion of the pathname delimited with colons (:) is an iRMX 86 logical 
name. A logical name identifies the device that contains the file; in some cases it 
also identifies a portion of the directory tree. In this example, LOC86 resides in 
a directory identified by the logical name :PROG:; MYPROGRAM.LNK 
resides in a subdirectory of a device identified by the logical name :FDO:. If you 
omit the logical name from the command (in this case, LOC86), the Operating 
System automatically searches several directories for the command. The direc- 
tories searched and the order of search are iRMX 86 configuration parameters. 
If you omit the logical name from a file used as a parameter (in this case 
PROGDIR/MYPROGRAM.LNK), the Operating System assumes that the file 
resides in the default directory (:$:). 

• Slashes (/) and up-arrows or circumflexes (A) separate individual components of 
the pathname. A file's pathname can consist of several components, depending 
on where the file exists in the overall directory tree. To identify a file, you start 
with a logical name (or assume the default), continue through the directory tree 
specifying as many directory names as necessary, and finally specify the name of 
the file with which you are concerned. You use separators between the 
individual components of the pathname (except immediately after the logical 
name). The slash separator tells the Operating System to search down one level 
in the directory tree for the next component. The circumflex separator tells the 
Operating System to search up one level in the directory tree. For example, if 
file TEXTFILE.P86 resides in directory PROGRAMS, and if directory 
PROGRAMS resides on a device identified by logical name :FD1:, you can 
identify the file by specifying the following pathname: 

:FD1 :PROGRAMS/TEXTFILE.P86 

• Continuation lines are necessary when a command or invocation will not fit on 
one line. The following example illustrates the line-end conventions to use and 
the continuation characters to expect: 



* * 



LINK86 :WD1 :PROG/TEST.0BJ , :WD1 : PR OG / S M A L L . L I B , 
USER. LIB TO : WD1: PROG/TEST BIND<cr>' 



• The LIB86 utility presents an exception to these prompt conventions. Because 
this program is interactive, it has its own prompts: 



LIB86<cr> 



iRMX 86 8086 LIBRARIAN \lx.y 



* 



ADD :F1:SEC.LNK, :F1:CSC.LNK, &<cr> 
:F1:TAN.LNK TO : P ROG : L I B R AR Y /T-R I 6 . L I B <c r> 



Related Publications 

The following manuals may be helpful during various aspects of your work with the 
iAPX 86, 88 utilities on an iRMX 86-based system: 

• Introduction to the iRMX 86 Operating System, order number 9803 1 24 

• iRMX 86 Human Interface Reference Manual, order number 9803202 

• iAPX 86, 88 User's Manual, order number 2 1020 1 

• PASCAL-86 User's Guide, order number 121539 

• PL/M-86 User's Guide, order number 121636 

• ASM86 Language Reference Manual, order number 1 2 1 703 

• ASM86 Macro Assembler Operating Instructions for 8086-Based Development 
Systems, order number 121628 

• FOR TRAN-86 User's Guide, order number 1 2 1 570 
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Generating Code to Run on an iRMX 86-Based 
System 

To generate code that runs on an iRMX 86-based system, perform the following 

steps: 

1. Translate the program into object code by using the appropriate compiler or 
assembler. 

2. Use LINK86 to link the program with other routines or libraries as necessary. 
When doing this, remember the following: 

• If you wrote your program in FORTRAN or Pascal, or if you invoked 
specific universal development interface (UDI) calls, you must link your 
program to the iRMX 86 UDI library that corresponds to the model of 
segmentation for your program. These libraries are: 

Library Model of Segmentation 

URXLRG.LIB LARGE or MEDIUM 

URXCOM.LIB COMPACT 

URXSML.LIB SMALL 

• Do not use FASTLOAD control. Currently, the iRMX 86 Operating System 
cannot load programs linked with this control. 

• To produce LTL code, use the BIND control. In this case, also specify the 
MEMPOOL and SEGSIZE controls to allocate memory for the memory 
pool and stack. If you do not use BIND, you must specify SEGSIZE with 
the LOC86 command. 

3. If you did not specify the BIND control in the LINK86 command, use LOC86 to 
assign absolute addresses to your program. In order to run this program in an 
iRMX 86 environment, you must also reserve the program's memory locations 
during iRMX 86 configuration. 

4. To invoke the program from a terminal, enter the pathname of the file that 
contains the program's linked (if LTL code) or located object code. 



Program Development Examples 

The following examples are programming problems solved by using one or more of 
the iAPX 86,88 utilities on an iRMX 86-based system. 



Example 1: Using CREF86 

Figure J-1 illustrates a CREF86 cross-reference listing for an input list of 15 files, 
one of which contains several modules. The output print file pathname OUT and a 
title for the listing were specified in the controls. Although PAGEWIDTH (PW) and 
PAGELENGTH (PL) specifications were also noted in the controls, the numbers 
specified are the same as those provided by default. 
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EXAMPLE OF CROSS REFERENCE USING CREF86 



IRHX 86 CREF86 Vx.y 
INPUT FILES: 



OUTPUT FILE: 
CONTROLS SPECIFIED: 



:F1 :PARSE.OBJ 
:F1 :SCANNR.OBJ 
:F1 :UOSHA.LNK 



:F1 :STAIE.OBJ 
:F1 :SCUIIL.OBJ 



F1 rROOT.OBJ 
F1 :MENMAN.OfiJ 
F1 :SORT.OBJ 
OUT 

PR(OUT) TT(EXAHPLE OF CROSS REFERENCE USINU CREFtib) Pb(120) PL(60) 



:F1 :SiaNON.OBJ 
:F1 :PROC£S .OBJ 
URXCOH.LIB 



:F1 :ERROR .OBJ 
:F1 iLIST.OBJ 



:F1 :UTILS.OBJ 
:F1 :LSUTIL.OBJ 



MODULES INCLUDED: 



FILE NAME 



: ROOT. OBJ: 
:PARSE.OBJ : 
iSIQNON .OBJ : 
: ST ATE. OB J : 
:ERROR .OBJ : 
lUTILS.OBJ: 
:F1 :HEHMAN.OBJ : 
:F1 :SCANNR.OBJ : 
:F1 :FR0CES.OBJ : 
:F1 :SCUTIL.OBJ: 
:F1 :LIST.OBJ: 
:F1 :LSUTIL.OBJ : 
:F1 :SORT.OBJ : 
:F1 :UDSMA.LNK: 
URXCOH.LIB 



:F1 
:F1 



:F1 
:F1 



MODULE NAHE(S) 

CREF86 

PARSE 

SIGNON 

NEXTSTATE 

ERROR 

UTILITIES 

MENORYHANAGEMENT 

SCANHOOULES 

PROCESSRECOROS 

SCANUTILITIES 

LISTOUTPUT 

LISTUTILITIES 

SYHBOLSORT 

OEJHAN 

DQALLOCATE 

DQDETACH 

DQGETTIHE 

SISTEMSIACK 



DQATTACH 

DQEXIT 

DQOPEN 



OQCHANGEEXTENSION 

DQFREE 

DQflEAD 



DQCREATE 

DQGETARGUMENT 

OQSEEK 



OQUECODEEXCEPTION 
OQGETSISTEHID 
DOkRITE 



CR£Fd6 EXAMPLE OF CROSS REFEHtNCfc USING CRtFo6 



SlMbOL NAME 



SiMBOL TIPE 



DEFINING MODULE; HEFERfilNG MOOULECS) 



ACCESS_PAGE . , 
ALLOCATE. . . . 
APPENDNODE. . . 
APPE'NDUDSHNODE. 



BUBBLESORTVARNAMES. 



CHECKOVERLA^ , 
CHECKVAhTli-E. 



UNKNOWN 






OBJMAN 




UNKNOWN 






OBJMAN 




PROCEDURE 


NEAR 




UTILITIES 




PROCEDURE 


NEAR 




UTILITIES ; 


PARSE SCANhODULES 


POINTER 






SYMBOLSORI ; 


LISTOUTPUT 


PROCEDURE 


WORD 


NEAR 


UTILITIES ; 


PARSE 


PROCEDURE 


WORD 


NEAR 


UTILITIES ; 


LISTUTILITIES 


PROCEDURE 


NEAR 




SYMBOLSOHT; 


LISTOUTPUT 


PROCEDURE 


NEAR 




LISTUTILITIES; 


LISTOUTPUT 


PROCEDURE 


NEAR 




SCANUTILITIES ; 


SCANHODULES 


PROCEDURE 


NEAR 




SCANUTILITIES ; 


SCANMODU LES 


CROCEDUHE 


BiTE 


NEAR 


SCANUTILITIES ; 


f ROLESi hECOhLS 



PfiOCESSfiECORDS 



EXAMPLE OF CROSS REFERENCE USING CREF66 



UNL0AD_PAG6 UNKNOWN 

VARAREAP POINTER 

VBLOCKLlSlhEADEh WORD 

WARNING PROCEDURE NEAR 

WRllEDATA PROCEDURE NEAR 

WRITEINITLINEBUF PROCEDURE NEAR 

WRITELINE PROCEDURE NEAR 

WRITENEWLINE PROCEDURE NEAR 

WRITETOCOMMANOBUF .... PROCEDURE NEAR 

URITETOPILE PROCEDURE NEAR 

-ZSSO WORD 



MEMORllMANAGEMENT ; 
PROCESShECORDS; 

ERROR; 

LISTUTILITIES ; 
LISTUTILITIES ; 
LISTUTILITIES ; 
LISTUTILITIES ; 
PARSE 

LISTUTILITIES ; 
UTILITIES 



PROCESSRECOROS LISTOUTPUT SYMBOLSOHT 
UTILITIES LISTOUTPUT SXMBOLSORT 

SCANMODULES PfiOCESSRECORDS 
ERROR UTILITIES LISTOUTPUT 
ERROR UTILITIES LISTOUTPUT 

LISTOUTPUT 

UTILITIES LISTOUTPUT 
ERROR LISTOUTPUT 



Figure J-1 . CREF86 Cross-Reference Listing 
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Example 2: Building and Using Library Files 



A library is a file that contains object modules. Libraries allow you to collect 
commonly-used pieces of software into one file. The library file can be included in a 
LINK86 invocation, and LINK86 will use the modules to resolve references. 



You can add the output from a translator, LINK86, or LOC86 to a library. The 
modules added may be relocatable or absolute; they can have unresolved references 
or be completely linked. 



Let's consider the following scenario — we have created six routines (SINE, 
COSINE, TANGENT, COSECANT, SECANT, and COTANGENT). We want to 
create a library file that will allow each routine to be linked to programs separately. 



The first step necessary to create the library is to translate each routine separately. If 
we were to put them in a single source module, the translator would translate them 
into one module with six public symbols. We could add this module to a library, but 
when we tried to link one of the routines into a program, all six would be included. 



Once the routines are translated, LIB86 can be used to create a library file and add 
modules. The LIST command is used to display the contents of the library and the 
publics contained within it. 



LIB86<c r> 



iRMX 86 8086 LIBRARIAN Mx.y 



CREATE : PROG: LIBRARY/TRIG. LIB<cr> 
ADD : FDO-.SIN .OBJ , :FD0:COS.OBJ TO : P ROG :"L I B R AR Y / T R I G . LIB<cr> 
LIST :PROG: LIBRARY/TRIG . LI B PUBLICS<cr>! 



:PROG:LIBRARY/TRIG. LIB 
SIN 

SINE 
COS 

COSINE 



ADD : FDD : SEC . LNK, : F D 0 : . C S C . L N K , : F DO : COT .IN K ^ 

:FDO:TAN.LNK TO : P R 0 G : L I B R A R Y / T R I G . L I B <cr> 
LIST :PROG:LIBRARY/TRIG.LIB PUBLICS<cr> 



:PR06:LIBRARY/TRIG.LIB 
SIN 

SINE 
COS 

COSINE 
SEC 

SECANT 
CSC 

COSECANT 
COT 

COTANGENT 
TAN 

TANGENT 



E X I T < c r > 
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Example 3: Linking and Locating Programs with Overlays 
Using OVERLAY Control 

The easiest way to build an 8086 program that contains overlays is with LINK86's 
OVERLAY control. Overlay modules built with this control reside in the same file 
as the root. The operating system supplies routines that will load the overlays con- 
structed in this way. See the iRMX 86 Loader Reference Manual or the Run-Time 
Support Manual for iAPX 86, 88 Applications . 

After the program modules that will constitute the root and its overlays are 
translated, each of the overlays and the root must be linked separately. Then the 
root and all of the overlays are linked together. 

The example following shows the first step toward linking overlays — linking all of 
the modules that will constitute each overlay and the root separately: 



LINK86 0V1.0BJ, OVIA.OBJ, OVIB^OBJ &<^> 
OVERLAY (OVER LAY1 )<cr>" " 



LINK86 0V2.0BJ, 0V2B.0BJ, 0V2C.0BJ &<cr> 
OVERLAY (0VERLAY2)<cr>| 





Mb 


0V3.0BJ , 


0V3A.OBJ 


OVERLAY (0VERLAY3XC r>j 




VlU 


JK86 


OVA. OBJ , 


0V4A.0BJ 


0VERLAY(0VERLAY4)<cr>| 



1LINK86 ROOT, 


.OBJ , 


ROOTA, 


,OBJ, ROOTB. 


OBJ , 


&<cr>| 


QURXSML. LIB 


OVER 


LAY (ROC 


)T)<cr>H|H 







Notice that all of the modules, including the root, are linked with the OVERLAY 
and NOBIND controls. The overlay name for the root is not as critical as for the 
overlays, since the overlay name is used when calling the loader. 

Finally, the overlays and root must be linked together. Since any one of the files 
could be the root, LINK86 requires for the final link the file containing the root 
must be first in the input list. During this final link, the OVERLAY control is not 
used: 





56 


ROOT , 


. LN 


K, 


0V1 , 


.LNK, 0V2.LNK, 0V3.LNK, 


&<c r> 


ta0V4. 


, L^ 


JK TO 


PR 


06. 


.86 E 


n N D < c r > ^■■■I^HI^I 





In the invocation, the BIND control is specified. The resulting object file is exe- 
cutable on an iRMX 86-based system. 

Figure J-2 shows the LINK86 print file listing for the previous invocation. 

There is nothing special about the invocation line to LOC86 when locating a file that 
contains overlays or that has been bound: 



L0C86 PROG. 86 RESERVE (OH TO 77FFH, &<cr> 
OFCOOOH TO OFFFFFH)<cr>! 



The RESERVE control prevents LOC86 from assigning memory addresses reserved 
for the Operating System. However, the values you enter with the RESERVE con- 
trol must depend on the size and location of your Operating System and other 
application software. Figure J-3 illustrates the printout from this invocation. 
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iRMX 86 8086 LINKER ,|Vx./ 



INPUT FILLS: ROOI.LNK, 0V1.LMK, 0V2.LMK, 0V3.LNK, OV<i.LllK 
OUTPUT FILE: PROG. 86 

COMTROLS SPECIFIED IH INVOCATION COMMAND: 
BIND 

DATE: AfM/OO/VC TIME: 



LINK MAP OF MODULE SOOT 



LOGICAL SEGMENTS INCLUDED: 
LENGTH ADDRESS ALIGN SEGMENT 

3CE7H G CODE 

ODOOH G CONST 

ZatOH G DATA 



CLASS 
CODE 
CONST 
DATA 



OVERLAI 
ROOT 
ROOT 
ROOT 



INPUT MODULES INCLUDED: 

ROOT.LNK(ROOT) 

OVI.LNK(PARSE) 

0V2.LNK(ILUDE) 

0V3.LNIC(PICILU0E) 

0V4.LNK(FASTL0AD) 



GROUP MAP 



GROUP NAME: 
OFFSET 
OOOOH 

BCEbH 



CGROUP 
SEGMENT NAME 
CODE\C0DE\R0OT 
C0DE\CQDE\PASS1 
C0DE\C0DE\PASS2 



SYMBOL TABLE OF MODULE ROOT 



BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


G(2) 


251CH 


PUB 


ACTUAL 


0(2) 


OFODH 


PUB 


ASSUMEROOTCONTRO 


G(2) 


0F22H 


PUB 


BASEFIXUPSEXIST 


G(2) 


OFOCh 


PUB 


-L 

BINDCONTKOL 


0(2) 


0D26H 


PUB 


bNODEID 


0(2) 


2tEAH 


PUB 


BUFEASE 


G(2) 


ODZtiH 


PUB 


CLASHNODEID 


0(2) 


0D5AH 


PUB 


COCONN 


G(2) 


OFOOH 


PUB 


COHHENTSCONTROL 


G(2) 


OF50H 


PUB 


CURHENTflLNUM 


G(2) 


OFlAb 


PUB 


CURRENTOVERLAYNU 


G(2) 


OFUEH 


PUB 


CURRENTRECINDEX 



-M 




OVERLAY NAME : ROOT. MODULE NAME ^ ROOT 



BASE 


OFFSET 


TYPE 


SYMBOL 


G(2) 


i|A20H 


SYM 


MEMORY 


G(2) 


ODOOH 


SYH 


LASTNMNODEID 


G(2) 


0D04H 


SYM 


LASTSGNODEID 


0(2) 


0D08H 


SYM 


LASTIDNODEID 


G(2) 


ODOCH 


SYM 


LASTEXNODEII) 


G(2) 


0D1OH 


SYM 


LASTGRNODEIO 


G(2) 


ODUH 


SYM 


LASTOVNODEID 


G(2) 


0D16H 


SYH 


LASTGNGDEID 



BASE 


OFFSET 


TYPE 


SYMBOL 


G(2) 


ooa2H 


SYM 


COPYRIGHT 


G(2) 


0D02H 


SYM 


FIHSTNMNOUEID 


G(2) 


0D06H 


SYM 


FIRSTSGNODEID 


G(2) 


ODOAH 


SYM 


FIRSTTDNODEID 


G(2) 


ODOEH 


SYM 


FIRSTEXNODEID 


G(2) 


0D12H 


SYM 


FIRSTGRNODEID 


G(2) 


0D16H 


SYM 


FIRSTOVNODEID 


Q(2) 


0D1AH 


SYH 


FIRSTBNODEID 



OVERLAY NAME = ROOT, MODULE NAME = LIT 



BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


G(2) 


4A20H 


SYH 


HEMORY 


G{2) 


003CH 


BAS 


SGNODE 


G(2) 


0F56H 


SYM 


LITBASE 


G(2) 


0F58H 


SYM 


LITID 


0(2) 


0F56H 


BAS 


LITNODE 


G(2) 


0F5AH 


SYM 


FIRSINODEIOS 


G(2) 


OF6'4H 


SYM 


FIRSTNODE 


G(2) 


0F8EH 


SYM 


CURRENTRECINDEX 


G(2) 


0F96H 


SYM 


TEMPLATE 


G(2) 


0FB9H 


SYM 


II 


G(1) 


016EH 


SYM 


GETLIT 


STACK 


0006H 


SYM 


INDEX 


STACK 


0004H 


SYH 


I 


G( 1 ) 


0207H 


SYM 


SGLIT 



Figure J-2. LINK86 Listing for Program with Overlays 
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IRHX 86 8086 LOCATOR. Vx.y 

INPUT FILE: PROG. 66 
OUTPUT flLE: PROG 

CONTROLS SPECIFIED IN INVOCATION COMMAND; 

fi£Sei(VE(OH TO 77FFH,0FC000H TO OFFFFFH) 
DATE: UU/DD/YY TIME: 



SYMBOL TABLE OF MODULE ROOT 



BASE 


OFFSET TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 




1034H 


251CH PUB 


ACTUAL 


1034H 


OFODH 


PUB 


ASSUMEROOTCOMTRO 




103*H 


0F22H PUB 


BASEFIXUPSEXIST 


1034H 


OFOCH 


PUB 


-L 

BINDCONTROL 




103tH 


0026H PUB 


BNODBID 


1034H 


2'tEAH 


PUB 


BUFBASE 




103tH 


0D28H PUB 


CLASHNODEID 


1034H 


0D5AH 


PUB 


COCONU 




103'IH 


OFOOH PUB 


COHHENTSCONTROL 


103'IB 


0F5OH 


PUB 


CURRENTFILNUH 






0F1Ah PUE 


CURRENTOVERLAYNU 
-H 


103'tH 


0F8EH 


PUB 


CURRENTRECINDEX 






















OVERLAY 


= ROOT, MODULE = ROOT 












BASE 


OFFSET TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 




1034B 


4A20H SYH 


MEMORY 


103tH 


0002H 


SYH 


COPYRIGHT 






ODOOH SIM 


LASTNHNOOBIO 


103I)H 


0D02H 


SYM 


FISSTNMNOOBID 




1 03tH 


ODOtH SYM 


LASTSGNOOEIO 


103'tH 


0D06H 


SYH 


FIRSTSGHODEID 




1 031H 


0D08H SYM 


LASTTONODEID 


1034H 


OOOAH 


SYH 


FIRST? ONOOEID 




103'tH 


ODOCH SYM 


LASTEXNODEID 


103'IH 


GDOEH 


SYH 


FIRSTEXNODEIO 




lOjtH 


001 OB SYM 


LASTGRHODEID 


1034H 


0I)12H 


SYM 


FIRSTGBNODEID 






0D14U SYM 


LASTOVNODEIO 


1034H 


0D16H 


SYM 


FIRSIOVMODEID 




1034H 


0D18H SYM 


LASTBNODEIS 


1034H 


001AH 


SYM 


FIRSIBNODEID 




103tH 


0D1CH SYM 


SOKODEID 


1034H 


0D1EH 


SYH 


GRNOOEID 






















OVERLAl 


= ROOT, MODULE = LIT 












BASE 


OFFSET TJPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 




1 03'»H 


'♦A20h SYM 


MEMORY 


103'JH 


003CH 


SYM 


SGNODE 




1 03tH 


0F56H SYM 


LITBASE 


1034H 


0F58H 


SYM 


LITID 




1 03«H 


0F56H SYM 


LITNODE 


103f H 


0F5Ah 


SiM 


f IfiSTNODEIDS 




1 03tH 


OFbth SYM 


f IHSTNODE 


103tH 


OFBEH 


SYM 


CURNEhTRECINOEX 




1 Oj^H 


0F9&H SYH 


TEMPLATE 


1034H 


0FB9H 


SYM 


II 




076Ub 


016EH SYH 


GETLIT 


STACK 


0006H 


SYM 


INDEX 




STACK 


OOOIH SYH 


I 


07bOH 


0207H 


SYM 


SGLIT 






MEMORY 


HAP OF HODULE ROOT 












MODULE 


START ADDRESS FARAQHAPh s 14D6U 


OFFSET 


s 0006n 








SEGMENT 


MAP 














START 


STOP 


LENGTH ALIGN NAME 




CLASS 




OVERLAY 




07ii00h 


OBIEeu 


3CE7H M CODE 




CODE 




ROOT 




OBltEUH 


0F9BAH 


'(tD3H M CODE 




CODE 




PASS1 




064E6H 


OEOCEU 


2BE7H M CODE 




CODE 




PASS2 




OBtESH 


10337H 


tESOH M CODE 




CODE 




PIC_PASS2 





GROUP MAP 



ADDRESS 
07B00H 



103'>0H 



GROUP OR SEGMENT NAME 

CGROUP 
C0DE\CODE\RO0T 
C0DE\C0DE\PASS1 
C0DE\CODE\PASS2 
C0OE\CO0E\PIC_PASS2 
CODE\CODE\FASTLOAD 

OGROUP 
CONST\CONST\ROOT 
DATA\DATA\RO0T 
SIACK\STACK\ 



Figure J-3. LOC86 Listing for Program with Overlays 
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Example 4: Linking and Locating Programs with Overlays 
Without OVERLAY Control 

It is harder to produce overlay modules without using the OVERLAY control. 
However, sometimes it is necessary to build programs in this way, for example, 
building a program for running under an operating system that does not support 
overlay modules contained in the same file as the root module. 

But regardless of the reason, building overlays in this fashion places an extra burden 
on the programmer. He must do some of the work that would be left to LINK86 
(and LOC86) if he were to use the OVERLAY control. In the following example we 
prepare a root and two overlay modules in separate files. 

First we must compile all modules. Examples of the invocation lines are shown 
below: 









:ROOT 


.SRC 


SMALKc r>| 




















:0V1 . 


SRC 


SMALKc r> 


1 
















186 




:0V2. 


SRC 


SMALKc r> 


1 



In the next step we must link the root module to resolve external symbols with a 
library and to obtain a link map: 



LINK86 : F1 :ROOT. OBJ , USER. LIB MAP<cr> 



We will need the link map for locating purposes. The link map, shown in figure J-4, 
shows the size of each segment in the root. Since the overlays are self-contained 
except for references to the root, we do not need a link map for them. The PL/M-86 
listing files will show the size of each overlay's segments, as illustrated in figure J-5. 

Note that the length of the root's code segment and OVl's code segment must fit 
within 64K. This means that the code for the overlays must be in a part of memory 
contiguous with the root (to avoid altering the CS register during execution). OV2's 
CONST and DATA segments are larger than OVl's so that the STACK segment 
must be placed to leave room for 0V2's CONST and DATA segments. If the 
overlays share the STACK and MEMORY segments with the root, they must be 
located at the same address. 



iRMX 86 8086 LINKER, Vx.y 

INPUT FILES: : F 1 : ROOT .OBJ , USER .LIB 
OUTPUT FILE: :F1:H00T.LMK 

CONTROLS SPECIFIED IN INVOCATION COMMAND: 
HAP 

DATE: MM/DD/YY TIME: 



LINK MAP OF MODULE LOANER 



LOGICAL SEGMENTS INCLUDED: 

LENGTH ADDRESS ALIGN SEGMENT 

8A9BH H CODE 

O38IH W CONST 

O29IH W DATA 

OO3OH W STACK 

OOOOH U HUMORY 



CLASS 

CODE 

CONST 

DATA 

STACK 

MENORX 



INPUT MODULES INCLUDED: 
:F1 :fiOOT.OBJ(ROOT) 
:fO:uS£K. LIB (LOADER) 
:FO:USER.LIB(EXIT) 
:F0:USEH.LIblERROR) 
:FO:USER.LlblTIME) 



Figure J-4. LINK86 Map for Root File 
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0V1's segment size information 

MODULE INFORMATION: 

CODE AREA SIZE 
CONSTANT AREA SIZE 
VARIABLE AREA SIZE 
MAXIMUM STACK SIZE 
918 LINES READ 
0 PROGRAM ERROR(S) 

END OF PL/M-86 COMPILATION 



= 7531H 30001D this is the CODE segment 

= 0081H 129D this is the CONST segment 

= 0181H 385D this is the DATA segment 

= 0040H 6AD this is the STACK segment 



0V2's segment size i n format i on 



MODULE INFORMATION 

CODE AREA SIZE = 1B9AH 7066D this is the CODE segment 

CONSTANT AREA SIZE = 0101H 257D this is the CONST segment 

VARIABLE AREA SIZE = 0454H 11080 this is the DATA segment 

MAXIMUM STACK SIZE = 0067H 103D this is the STACK segment 
918 LINES READ 
0 PROGRAM ERROR(S) 

END OF PL/M-86 COMPILATION 



Figure J-5. Module Information for Overlays 



After computing the required location for the root's DGROUP and STACK, we can 
locate the root module. The resulting file will not be executable, but it allows us to 
resolve references to the root's code and data symbols in the overlays. The following 
LOC86 invocation will leave room for the overlays' code segments and place the 
DGROUP in the first unused memory location. (In the command line below, the DS 
register is initialized to OFFCEH, and the CS register is initialized to 0.) The STACK 
and MEMORY segments will be located above OV2's DATA segment: 



* 

** 
** 



L.0C86 : F1 :ROOT. LNK &<cr> 
ADDRESSES(GR0UPS(CGROUP(0H),D6ROUP(0FFCEH)), &<cr> 

SEGMENTS(CODE(0H),CONST(0FFCEH),STACK(10B34H))) & <c r> 
ORDER (-SEGMENTS (CODE, CONST, DATA, STACK, MEMORY)) &<cr> 
SEGSIZE(STACK(100H))<cr> 



Once the root is located, we can use it to resolve external references in the overlay 
modules. The overlay modules cannot call each other, since only one is resident in 
memory at any time. The link commands are shown below. The NOPUBLICS with 
the EXCEPT control is used to avoid conflicts when we use the located overlays to 
resolve external references in the root: 



** 



LINK86 : F1 :0V1 .OBJ ,PUBLICSONLY ( : F1 :ROOT) &<cr> 
NOPUBLICS EXCEPT(0V1C0DE, OVlDATA)<cr>i 



LINK86 : F1 :0V2.. OBJ ,PUBLICSONLY (: F1 -.ROOT) &<cr> 
NOPUBLICS EXCEPTCJ3V2C0DE, UV2DATA)<cr> 



The PUBLICSONLY control resolves references to public symbols contained in the 
root. 
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After the overlays have been linked, they must be located. The code and data 
segments must be placed in the memory locations that were reserved when we first 
located the root. In this case the STACK and MEMORY segments must be the same 

for the overlays and the root: 



* 

* * 
** 
** 



L0C86 : F1 :0V1 . LNK &<c r> 
ADDRESSES (GROUPS (CGROUP(0H),DGROUP(0FFCEH)), S<cr> 

SEGMENTS (CODE (8 A9CH),CONST(105E0H), S T AC K (1 0 B3 4 H ) ) ) &<cr> 
ORDER (SEGMENTS (CODE, CONST, STACK, MEMORY)) &<cr> 
SE6S IZE (STACK (1 OOH) ) <c r> 



* 



L0C86 : F1 :0V2. LNK &<cr> _ 
ADDRESSES (GROUPS (C GROUP (OHT, DG ROU P ( 0 F F C E H ) ) 

SEGMENTS(CODE(8A9CH),CONST(105E0H),STACK(10B3 4H))) &<cr> 
ORDER (SEGMENTS (CODE, CONS T, DA TA, STACK, MEMORY)) &<cr> 
SEGS IZE (STACK (1 OOH) ) <c r> 



The CGROUP and DGROUP base address must be specified in order to compute 
offset information. The final base address assigned to DGROUP by LOC86 will be 
rounded down to OFFCOH. 

Once the overlays are located, the root is linked and located into an executable form. 
The PUBLICSONLY control will resolve references to symbols in the overlay 
modules. Other than the addition of this input control, the LINK86 and LOC86 
command must be identical to those used previously: 



LINK86 : F1 :ROOT. OBJ , USER. LIB, &<cr> 
PUBLICSONLY (: F1 :0V1 ,: F1 :0V2)<cr>^ 



* 
* 

•k* 
if* 



L0C86 : F1 :R00T. LNK &<cr> 
ADDRESSES(GROUPS(CGROUP(0H),DGROUP(0FFCEH)), &<cr> 

SEGMENTS(CODE(0H),CONST(0FFCEH),STACK(10B34H)) 
ORDER(SEGMENTS(CODE, CONST, DATA, STACK, MEMORY)) S<cr> 
SEGSIZE(STACK(100H))<cr>| 



The executable forms of the root and its overlay files are contained in :Fl:ROOT, 
:F1 :0V 1 , and :F1 :OV2. Figure J-6 shows the resulting layout of memory. 



ROOT CODE 
SPACE 



OVERLAY 
CODE 
SPACE 



ROOT DATA 
SPACE 



OVERLAY 
DATA 
SPACE 



STACK AREA 



8A9B 
8A9C 



OFFCO 
OFFCE 



105DF 
105E0 



10B33 
10B34 



10033 
10C34 - 



-CS 



•DS, SS 



Figure J-6. Memory Organization for Example 4 
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Invocation Examples 

The following foldout pages contain examples of the iAPX 86,88 Family utility con- 
trols and commands. The examples may be used in conjunction with syntax 
specifications given: 

• In Chapter 2 for LINK86 

• In Chapter 3 for CREF86 

• In Chapter 4 for LIB86 

• In Chapter 5 for LOC86 

When using the directions in these chapters, fold out the page in this appendix con- 
taining examples of the command or control in which you are interested. 

The following is a sample iRMX 86 OH86 invocation: 



0H86 : FDO : FINALPROGRAM to : F DO : F I N I S H . H E X <c r> 
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Comments 

This example defines two public symbols, VARONE 
and VARTWO, with absolute addresses 50H and 
2000 H, respectively. 

In this example, the root file is RTFILE, and LIB1 and 
UB2are library files. 



This line creates an LTL module. The output object 
file is -.FDO-.TEST with no extension. 



This example specifies default to avoid ambiguity. 



Do not use the FASTLOAD control when producing 
code for an iRMX environment. 



LINES is the default, so it need not be specified. 



This MEMPOOL example will increase the minimum 
dynamic memory requirements by 20H bytes, and by 
default the maximum size will increase, if necessary, 
to equal the minimum. 

The minimum dynamic memory requirement is 100H. 
The maximum dynamic memory requirement is 
300H. 



iRMX86LINK86 EXAMPLES 



Control Examples 
ASSIGN 

ASSUMEROOT 



BIND/NOBIND 



COMMENTS/NOCOMMENTS 



FASTLOAD/NOFASTLOAD 

INITCODE 
LINES/NOLINES 

MAP/NOMAP 



MEMPOOL 



5link86 file1 , file2, 
Sassign (varone(50h; 
aVARTWO(2000))<cr> 



<c r> 




ILINK86 R00T1.0BJ, R00T2.0BJ, &<cr>j 
ailBl , LIB2 TO RTFILE OVERLAY<cr>l 



SLINK86 0V11 .OBJ, 0V12.0BJ, &<cr>i 
JLIBI , LIB2 TO 0V1 .OBJ &<cr>| 
aOVERLAY ASSUMEROOTCRTFILEXc 



SLINK86 0V21.0BJ, 0V22.0BJ, S <c r> 
3LIB1, LIB2 TO 0V2.0BJ S<cr>M| 
SOVERLAY ASSUMEROOT (RTF I LE) <c r>i 



SLINK86 : FDO : TEST . OBJ , &<cr>B| 
83:,PR0G : LIBRARY/ USER. LIB &<cr>i 



SLINK86 :WD0:SYSTEM/PR06.0BJ &<cr> 
JTO :WDO:SYST EM/TEMP.TST S<cr>Mi 
9C0MMENTS<C 



iLINK86 PROG .OBJ , LIB1 
SBIND FASTLOAD<c r>Hi 



LIB2 &<cr> 



LINK86 : FD1 :MAIN , 


.OBJ, I 




g-.PROG-.USER .OBJ , 


&<c r>| 




BpUBLI CSONLt ( : FD( 


):8087, 


,LOC) &<cr> 





BLINK86 : FDO :TEST.OBJ , 
touSER.LIB, PASCAL. LIB 
BmEMPOOL( + 20H)<c r>MM 
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Comments 

The LINK86 output module will have the name 
specified in parentheses in the control. 



This example removes all debug and public records 
from the object file. 



The EXCEPT In the NOPUBLICS overrides the 
PURGE. 



This use of ORDER specifies the order of segments 
for two groups. 



This example will create an overlay record. The 
name of the overlay will be 0VERLAY1 . 



First the constituent files must be linked to form 
overlays. 



The print file is :FD0:USER/TEMP1.MP1. 

The print file is .Fl :PR0G.MP1 . 
The print file is -.FV.THE.MAP. 

This example removes information about line 
numbers, local symbols, and comments from the 
print file. 



This statement removes all but the segment informa- 
tion and error messages from the print file. 



iRMX 86 LIN K86 EXAMPLES 



Control Examples 

NAME 



OBJECTCONTROLS 



ORDER 



OVERLAY/NOOVERLAY 



PRINT/NOPRINT 



PRINT CONTROLS 



□ LINK86 :USER:TOM. LBJ , 
&/SYS . LIB NAME &<cr>i 
BCTHIS IS A VERY LONG 



MODULESNAME . ) <c r>| 



SLINK86 : F1 :SRC1 .OBJ 
3: F1 : SRC2, OBJ , : WDO 
SnAMECTEST 5.3)<cr>| 



&<c r>H 

USER . LIB 



&<c r>| 



5LINK86 :F1: FINAL, &<cr>Hi^J 
a:FD1 :USER.LIB, SYS. LIB S<cr>^ 
SOBJECTCONTRaLSCPURGEXc r>WM 



LINK86 :PR0G:PASCL1 .OBJ &<cr> 
Bob J ECTCONTROLS (PURGE , &<cr> 
HnDPUBLICS EXCEPTCS TART, S<cr> 
DdATAI , DATA2) )<c r>HH|i^H 



BLINK86 FILE1 , FILE2, F ILE3 &<cr>, 
S3T0 :FDO:OV1.LNK &<cr>|^HBBH| 
B0VERLAY(0VERLAY1)<c r>^^^^^| 



LINK86 FILE4, FILES, FILE6 S<cr> 




TO : FD0:OV2. LNK &<cr> 
OVERLAY (0VERLAY2) <cr> 


■■■ 



L1NK86 FILE7, 


FILE? 


I, FILE9 


&<c r> 


DTO :FDO:ROOT 


LNK ( 


)VERLAY ^ 


y<C r>| 





3: FDO :0V1 . LNK, : F DO : 0V2 . LN K<c r>| 



h^INK86 : FDD : USER/PROG . OBJ &<cr>^ 
DTO : FDO :U SER/TEMP1 .TST S<cr>M 
QPR INKc r>^^HH^^H|H|H 



V 


NK86 : PROG : PROG . 0£ 


5J, 


&<c r> 


B 


PR0G:USER. lib PRH 


JT I 


Ucr>| 


B( 


: Fl : THE . MAP) <c r>l 







SLINK86 : WDO : TEMP . OBJ BIND &<cr> 
jPR INTCONTROLS (NOLINES , &<cr>B| 
aNOCOMMENTS, N 0 S Y M B 0 L S X c r>||M 
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Comments 

Public information concerning only DATA1, DATA2, 
LABELS, and PR0C4 is placed in the object file and 
print file. 

All public symbol information will be included in the 
print file and output file. 

This example will produce a file containing only the 
absolute public symbol records from :F1:8087.LOC. 
The object file will be :F1 :8087.LNK. 

This will resolve the references in ROOT. OBJ to 
absolute public symbols in the separately linked and 
located overlays 0V1 and 0V2. 

This produces an object file containing no debug or 
public information. 

This confirms that the line and symbol information 
should be kept in the print file. 

This will change the translator-assigned name 
CGROUP to THE@C0DE. A subsequent linkage 
would not combine THE@CODE with a group named 
CGROUP. 

This changes the name of the CODE group to 
CGROUP. 

This tells the loader that 15FFH bytes of code is the 
minimum requirement for MEMORY. The new max- 
imum size of MEMORY is 35FFH. 



This increments MEMORY'S minimum size by 1FFH 
(7951 D) bytes. The maximum size of MEMORY is 
equal to the old minimum size plus 3FEH (15902D). 

The local symbol records will be included in the 
object file. 



PURGE is a shorthand for NOSYMBOLS, 
NOCOMMENTS, NOPUBLICS, NOTYPE, and 
NOLINES. 

SYMBOLCOLUMNS has no effect, since BIND was 
not specified. 

The symbol table will be printed on a line printer. 



LIBMOD will retain its type information. 



Control 

PUBLICS/NOPUBLICS 



PUBLICSONLY 



PURGE/NOPURGE 



RENAMEGROUPS 



SEGSIZE 



SYMBOLS/NOSYMBOLS 



SYMBOLCOLUMNS 



TYPE/NOTYPE 



iRMX 86 LINK86 EXAMPLES 

Examples 



LINK86 : F1 :TEST . 06 J , a<cr>HHH 

□user. LIB NOPUBLICS EXCEPT S<cr>H| 
B(DATA1, DATA2, LABEL3, PR0C4)<c7>l 

aURXSML.LIB, USER. LIB PUBLI CS<c r>i 



ILINK86 : F1 :ROOT.OBJ , 
3PUBLICS0NLY(: F1 :0V1 



: F1 :0V2)<c r>| 



[LINK86 :WDO : F I N A L.OBJ &<cr>| 
flPRINTCONTROLS (NOPURGEXc r>| 

riNK8^^^pSpR^^&<^l 
QRENAMEGROUPS ( CGROUP TO <cr>] 
Bt H E q) C 0 D E X c r>HHHHH 



pNK86 :WD1 : ASMPRGrOBJ&<cr>||HB 

BRENAMEGROUPSCCODE to CGROUP)<cr>| 

riNK8^^^^E0RG^^^T<^Hl 

DUSER.LIB, SYSTEM. lib BIND S< cr>l 

Hs E G S I Z E ( M E M O RY (15FFH, &<cr>BM 

H+zooOH) )<c r>HHlHHHHii^^l 



|LINK86 :WFDO:PROJECT.OBJ, S<cr>| 
DiWDO :REST. LIB SEGSIZE &<cr>jjjai 
B(MEMORY ( + 1 F,F , +1 FF) ) <c r>MI||^B 

0: F1 :USER.LI B NOSYMBOLS &<cr>M 
Bs Y M 6 0 L S < c r >liHHHHHHHifl 



LINK86 : FDO -.TEST .OBJ , &<cr> 
D: FD1 : SYST EM/USER . LIB S<c r> 
BpURGE<c r>|^BM— M 

|^K8^^^^^^^& <^B 

□SYMBOLCOLUMNS (1) <c r>BHH 



LINK 


86 : 


F1 : ROOT . Lf 


a, 






: F1 


:0V1 


.LNK, : F1 ; 


; 0V2 


.LNK, &<cr> 




PUB 


Lies 


ONLY ( : WD1 ; 


:808 


7) &<cr>HH 




,S YM 


BOLC 


OLUMNS (4) 


BIN 


D&<cr>J^H 




!PRI 


NT ( : 


LP : ) <c r>H 







LINK86 : F1 : LIBMOD. OBJ TYPE<c r> 
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Comments 

The cross-reference listing will have 35 lines on each 
page. 

The cross-reference listing will be 100 characters 
wide maximum per page. 



The pathname of the print file will be :FX1 :MYFILE. 



The message in the TITLE control must be placed on 
one line. If the message contains special characters, 
it must be enclosed in single quotes ('). 
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Control 



PAGELENGTH 
PAGEWIDTH 



Examples 



CREF86 :F1 :FILE1 , FILE. LIB S<cr> 
PAGELENGTH (35)<c r>i 



PRINT 
TITLE 



jCREF86 : PROG : PROGRAM, &<cr> 
S3:PR0G : LIBCMODD &<££>■■[ 
BPAGEWIDTHd OOXc r>Hi^^H 



jCREF86 
SaPRINT ( 



FX1 : FI LES (M0DULE1 
FX1 :MYFILE)<cr>B 



M0DULE2) &<cr> 



|CREF86 MYPR06, HISPR06, HERPROG, &<c 
BMYLIB, HISLIB, HERLIB TITLE &<££>■ 
HCA CROSS-REFERENCE^)&<cr>^^^H 
QPAGEWIDTMd 05)<c r>^^^^^^^H 
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Comments 

Three object files are added to the USER. LIB. 



Three modules from the library LIB. ABC are added 
to:FD0:PROJ.TOM. 

This command will produce an empty library file 
called TOMS.LIB. 



Four modules are deleted from the library USER. LIB. 



iRMX 86 LIB86 EXAMPLES 



Control 



Examples 



ADD 



* 



ADD : F1 :SIN, : F1 :COS, : F1 :TAN TO &<cr> 
: FO :USER . LIB<c r>r 



* 

it* 



ADD : FDO : LIB. ABC (MODI , M0D2, M0D3) &<Lr> 
TO : FDO : PROJ . T0M<c r>, 



CREATE 



CREATE :WDO :SYSTEM/TOMS. LIB<cr> 



CREATE : FO:USER. LIB<cr> 



FX1 :USER . LIB (TEMPI 
TEM TMP . TEST^Xc r>| 



[DELETE 

Draper 



: FO : 10 . LI B ( F LOPPY 
TAPEXc r>HHHi 



CRT, &<cr> 



EXIT 
LIST 



EX IT<c r> 



LIST USER. LIB<cr> 



USER. LIB 
TEMP 

TEST 
EXEC 
MAIN 
LOOP 



LIST USER. LIB(TEMP,TEST)<cr> 



USER . LIB 
TEMP 
TEST 



LIST USER. LIB, TEMP. LIB<cr> 



USER. LIB 

TEMP 

TEST 

EXEC 

MAIN 

LOOP 
TEMP .LIB 

M0DULE1 

M0DULE3 

MOOULETC 
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Comments 



If SEG1 is byte alignable, it will be located at 15FFH. 
If SEG2 is byte or word alignable, it will be at 4F5AH. 



Address assignment of groups, segments, and 
classes can be in any order, as long as addresses do 
not conflict with existing absolute addresses. 



A long jump to GO will be placed at location 
OFFFFOH. 



The initialization code is placed at address 32768 
decimal (8000H). 

No initialization code will be produced. 



LINES is the default, so it need not be specified. 



This statement removes all debug records from the 
object file, but keeps the information in the print file. 



NOPUBLICS is implied by PURGE, but PUBLICS 

overrides it. 

SEG@A of CLASS1 will be the first relocatable 
segment located. SEG@B will be next, followed 
immediately by any other segments contained within 
CLASS1. The extra segments in CLASS1 (and all of 
the segments in CLASS2) are located in the order in 
which they are encountered. Finally, the list in the 
SEGMENTS subcontrol is handled. 
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Control Examples 
ADDRESS 

BOOTSTRAP 
COMMENTS/NOCOMMENTS 

INITCODE/NOINITCODE 

LINES/NOLINES 
MAP/NOMAP 

NAME 

OBJECTCONTROLS 
ORDER 



SL0C86 :FD1:C0ME.LNK TO WENTT<cr>^^B 
JADDRESSES (SEGMENTS (SEG1 \CLASS2\ S<cr> 
30VERLAY3 (1 5FFH) , S E G 2 ( 4 F 5 A H ) )<c r>M^ 



IL0C86 :F1:IST.LNK TO L 0 C I S T^TTTTcrT^B 
JADDRESSES (SEGMENTS (SEG1 \C LAS SI &<c r>H| 
3(23H)), GROUPS (CGROUP(OOH) , DGROUP S<cr> 
jdOOOOH)), CLASSES(MEMORY(15000H)))<cr> 



BL0C86 : F1 : UPWARD .LNKT<cr>^^H 

taoBJECTCONTROLS (NOLINES, & <c r>| 
BnOCOMMENTS, NOSYMBOLSXc r>Ml 



JL0C86 : F3 : PASCAL1 . LNK &<cr>B[^^H 
gOBJECTCONTROLS (PURGE, PUBLICS)<cr> 



L0C86 : FO : SPCSEQ . LNK ORDER &<cr>H| 
D(CLASSES(CLASS1(SEGaA,SEGaB), &<cr> 
Be LASS2), SEGMENTS (SEG1\CLASS3 &<cr> 
H\0VERLAY1 . SEG22, SEG10\CLASS5) )<c r> 



I 
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Comments 

The print file is :F1 :TEMP1.MP2. 



The print file is ■.FDD0:INTERRUPT.IVIP2. 
The print file is :F1 :MAP. 

Information about line numbers is removed from the 
print file. 

All but the segment information is removed from the 
print file. 

No public information is included in the output files 
{:USER:PRIVATE.MP2 and :USER:PRIVATE). 

All public information will be included in both the 
print file and output file. 

The object file contains no public or debug informa- 
tion, and the symbol table does not appear in the 
print file. 

The line and symbol information will be kept in the 
print file. 

This control reserves the high-order 64K of memory. 



A 200H and a 100H section of memory at the top and 
bottom of memory are reserved. 

The size of segment MEMORY will be increased by 
2000 bytes. 

The size of segment MYSEG will be decreased by 
511 bytes. 

The new segment size for XENDA is 7770 bytes. 



:FD1 -.AUTO will start at IGNITION. 
■.PROG -.HALTS will start at location 200H. 



This statement will include the local symbol records 
in the object file and the symbol information in the 
print file. 

PURGE is a shorthand for NOSYMBOLS, 
NOCOMMENTS, NOPUBLICS, and NOLINES. 



The symbol table will be printed on a line printer. A 
line printer line can hold a four-column symbol table. 



Control 

PRINT/NOPRINT 

PRINTCONTROLS 
PUBLICS/NOPUBLICS 
PURGE/NOPURGE 

RESERVE 
SEGSIZE 

START 

SYMBOLS/NOSYMBOLS 
SYMBOLCOLUMNS 



iRMX 86 LOC86 EXAMPLES 
Examples 



L0C86 : F 1 : P R 0 G . L N K TO & <£Z>^^^^^^M 
fl: F1 :TEMP1 .TST P R I N T < c r>1^^^^^M 

I^CS^^^D^^mRRU^^^^^^^^^^B 

MCS^^To^RO^^T^^^^^^Am^l 



[L0C86 : F1 : LINEAR . LNK &<c r>B 
DPRINTCONTROLS (NOLINES)<cr>| 



L0C86 :UD1 : D I R 1 / S BP I R / PR . LN K &<cr>| 
□ PRINTCONTROLS (PURGE) <c r>HHHH 



,0C86 : USER : PR I VATE . LNK NOPUB L I C S <c r>| 



L0C86 :PROG:TEXT.LNK & <cr>] 
□NOPUBLICS PUBLICS<cr>HI 



IL0C86 : F3:PR0J5. LNK PURGE<cr>| 



L0C86 : FXO : B0 209 . LNK PURGE & <cr>M 
flPRI^^COf^^SCNOPU^^ 

□ (OFOOOOH TO OFFFFFH)<cr>BHHHI 



^0C86 : F2: HUGOS. LNK MSERVE&<cr>l|HB 

□(OOH TO 0200H, OFFFOOH TO OFFFFFH)<cr>| 



|L0C86 : UD1 : DIREC/GRO W. LNK SEGSIZE S<cf>| 
□ (MEMORY ( + 2000)) ^ ^ ^ ^m^mmggm^m^immmd 



kOC86 SEGPROB.LNK S EGSIZE S<cr>^^^M 
B(MYSE6(-1FFH))<c ^ ^ jj^j^H^^^^^J 

MC8^^^T^C^ ^^EGSIZ^<^^^B 
B(XENDA(7770) X c r>MWMBMI^Bii^^B 

Ocs^^^^^^^^^u^^m^mNK^l 



L0C86 ■■ PROG -. HALT S . LNK START S<cr>| 
□ (OOH, 20 0 HXC r>HHH[^H|HHHI 



|L0C86 : F3 : D I R2/TEST . LfU&<c7>^M 
HSYMBOLCOLUMNSdXc r>B|M[i^^B 

[ToCS^^^E^^^KE^^^^^HH 

□ SYMBOLCOLUMNS (4) PRINT( : LP:)<cr>| 
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Environmental Considerations 

The iAPX 86,88 Family utilities run on the Series IV Microcomputer Development 
System. These utilities can be used to produce code for an 8086-based host; the code 
can be executed on the Series IV if the code is load-time locatable (LTL). Resulting 
code is also compatible with DEBUG-86 and DEBUG-88 debuggers (if it is LTL 
code) and with ICE-86 and ICE-88 emulators (if it is absolute code). 

The following conventions of the Series IV operating system (iNDX) are 
encountered when running the utilities: 

• Each of the utilities is invoked by entering the name of the file in which the 

utility resides: 



LINK86 MYPROG . OBJ , HERPRi 



ISPRO.OBJ Tl 



tURPRO<c r> 



/SYSTEMDRIVE/L0C86 /W0RKDRIVEl/PR06.LNK<cr> 



• The Series IV pathname consists of path components, each preceded by a slash 
(/): 

/SYSA/JOHN/FILE.ABC 

• The directory-name is one or more path components consisting of 1 to 14 
characters, inclusive. One of the directory-name path components may be a 
"logical name." A logical name must be the first path component in a 
pathname and not preceded by a slash: 

SYSJOHN/FILE.ABC 

• A logical name for some directory may be defined as a null string. Null logical 
names do not appear in the pathname: 

FILE.ABC 

Examples in this appendix employ all these pathname variations. 

• Continuation lines are necessary when a command or invocation will not fit on 
one line. The following example illustrates the line-end conventions to use and 
continuation characters to expect: 



> 

>> 



LINK86 MYPROG .OBJ , /W0RKFILE1 /PAS86/HERPR0. OBJ , S<cr> 
/W0RKFILE2/PAS86/HISPR0.0BJ, /W0RKFILE3/F0R86/HERPR0 



Pathnames may not be split between lines. 

The LIB86 utility presents an exception to these prompt conventions. Because 
this program is interactive, it has its own prompts: 



LI B86<c r> 



i NDX 8086 LIBRARIAN Vx.y 
* ■■■■■■■I 



ADD LIB1 /PLM/SEC. LNK, L I 81 / P LM / C S C . LN K , &<cr> 
LI 81 /PLM/TAN . LNK TO L I B 1 / P LM / T R I G . L I B < c r> 
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iAPX 86,88 Family Utilities 



The following versions of the iAPX 86,88 Family utilities may be executed on the 
Series IV: 



LINK86: V2.0 or later 

CREF86: Vl.O or later 

L1B86: V2.0 or later 

LOC86: V2.0 or later 

OH86: Vl.O or later 



Related Publications 

The following manuals may be helpful during various aspects of your work with 
iAPX 86,88 utilities on the Series IV: 

• Intellec Series IV Microcomputer Development System Overview, order number 
121752 

• iAPX 86,88 User's Manual, order number 210201 

• Intellec Series IV ISIS-IV User's Guide, order number 1 2 1 880 

• Intellec Series I V Operating and Programming Guide, order num ber 121753 

• DEBUG-88 User's Guide, order number 121758 

• PASCAL-86 User's Guide, order number 1 21 539 

• PL/M-86 User's Guide, order number 121636 

• ASM86 Language Reference Manual, order number 1 2 1 703 

• ASM86 Macro Assembler Operator's Manual, order number 121628 

• 8089 Macro Assem bier User 's Guide, order number 980093 8 

• FOR TRAN-86 User's Guide, order number 1 2 1 570 



Program Development Examples 

The following examples are programming problems solved by using one or more of 
the iAPX 86,88 utilities on the Series IV to develop code for an 8086-based host. 



Example 1: Preparing to Use DEBUG-88 



There are only two steps to preparing your code for DEBUG-88 execution: 
translating the code, then linking it with BIND. 



First you must translate your code. Any of the 8086 translators will work, 
example of one such translation is shown below: 



An 



PLM86 TEST. SRC DEBUG SMALL<cr> 



Once the program has been translated, your must link the program with the BIND 
control. LINK86 with BIND produces an LTL module. The Series IV assigns 
addresses to LTL modules at load time. The invocation Hne for LINK86 when link- 
ing the program shown above might appear as follows: 



Llf 


^K86 TEST.OE 


5J, UTILS.OBJ, SMALL. LIB 


&<c r> 


TO 


TEST. 86 BH 
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In the above example note that all of the symbol information (LINES, SYMBOLS, 
PUBLICS) is left in the output object file. This will aid you while debugging your 
program. DEBUG-88 uses the symbol information to produce diagnostic information 
on the program. This information is also included in the symbol table. Figure K-1 
shows the print file from the invocation above. 

The libraries specified resolve all of the external references in TEST. OBJ. 

After the above linkage, the program can be executed with the following command 
to the Series IV: 



DEBUG TEST.86<cr> 



INOX oOttb LINKER, V x.y 






INPUT FILES: TESI.OBJ, UTlLS.ObJ 
OUTPUT FILE: TESI.ijb 
CONTROLS SPECIFIED IN INVOCATION 
BIND 

DATE: MM/DD/YY TIME: HH:MM:SS 


SMALL. Lib 
COMMAND: 




LINK MAP OF MODULE ROOT 






LOGICAL SEGMENTS INCLUDED: 
LENGTH ADDRESS ALIGN SEGMENT 

037DH W CODE 

OOOOH H CONST 

0192H N DATA 

03F8H W STACK 

OOOOH G ??SEG 


CLASS 

CODE 

CONST 

DATA 

STACK 

MEMORY 


OVERLAY 


INPUT MODULES INCLUDED: 

lEST.OBJ(ROOT) 

U TILS. OB J (UTILITIES) 

SMALL. LIB(OQATTACH) 

SMALL .LIB(DQCLOSE) 

SMALL. LIB (DQCRE ATE) 







GROUP MAP 



GROUP NAME: CGROUP 

OFFSET SEGMENT NAME 
OOOOH CODE 



GROUP NAME: 
OFFSET 
OOOOH 
0014H 
01AAH 
05A2H 



DGROUP 
SEGMENT NAME 
CONST 
DATA 
STACK 
MEMORY 



SYMBOL TABLE OF MODULE ROOT 



BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


G(2) 


016ltH 


PUB 


BINDCONTROL 


G(2) 


OOtAH 


PUB 


BNODEBASE 


G(2) 


0016H 


PUB 


BUFBASE 


G(2) 


OOUU 


PUB 


BUFLEN 


G(2) 


004CH 


PUB 


CLASHNOOEBASE 


G(2) 


005EH 


PUB 


COCONN 


0(2) 


015SH 


PUB 


COMMENTSCONTROL 


G(2) 


016FH 


PUB 


CURRENTOVERLAYNU 
-H 


G(2) 


0171H 


PUB 


DEBOGTOGGLE 


G(2} 


00A5H 


PUB 


DEFAULTPRTFILENA 
















-HE 




NODULE 


NAME = 


ROOT 












BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


G(2) 


05A2H 


SYM 


MEMORY 


G(2) 


OOOOH 


SYM 


COPYRIGHT 


G(2) 


QOItH 


SYM 


BUFLEN 


G(2) 


0016H 


SYM 


BUFBASE 


G(1) 


00F7H 


SYM 


ERROR 


0(1 ) 


OOFEH 


SYM 


WARNING 


G(2) 


0018H 


SYM 


LASTNMNODEP 


0(2) 


001 AH 


SYM 


FIRSTNMNODEP 


G(2) 


001CH 


SYM 


LASTSGNODEP 


G(2) 


Q01EH 


SYM 


FIRSTSGNODEP 


G(2) 


0020H 


SYM 


LASTTDNODEP 


G(2) 


0022H 


SYM 


FIRSTTDNODEP 


G(2) 


0024H 


SYM 


LASTEXNODEP 


G(2) 


0026H 


SYM 


FIRSTEXNODEP 


G(2) 


0028H 


SYM 


LASTGRNODEP 


G(2) 


002Afl 


SYM 


FIRSTGRNODEP 



Figure K-1 . LINK86 Print File for Bound Object Module 
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G(1 
G(1 
G(1 
G(1 
G(1 



OOAbH LIM 

OOBEH LIN 

OOCFH LIN 

OOODh LIN 

OOEEH LIN 



141 
144 
146 
149 
152 



G(1 ) 
G(1 ) 
G(1 ) 
G(1 ) 
G(1 ) 



00B3H LIN 

00C8H LIN 

00D2H LIN 

00E7H LIN 

00F5H LIN 



143 
145 
148 
150 
153 



BEFERENCES TO SEGMENT BASES EXIST IN INPUT MODULES: 
ROOT 



Figure K-1 . LINK86 Print File for Bound Object Module (Cont'd.) 



Example 2: Preparing to Use an ICE System 

Another way to test and debug software is using an in-circuit emulation (ICE) 
system. The ICE-86 or ICE-88 loader can load only absolute object modules. 
Therefore, you cannot use the output from LINK86 immediately; it must be located, 
too. 

The whole process of preparing a program for ICE system execution takes three 
steps. In the first two, the program must be translated and linked: 



The above example shows a straightforward linkage with no change to the default 
control setting. Note that NOOVERLAY and NOBIND, the defaults, are set. The 
ICE loader has no facility for dealing with overlay modules created by using the 
L1NK86 OVERLAY control. In this case there are no unresolved external references 
in the object module. If the module did contain unresolved references, it could still 
be executed by the ICE system. However, as with execution under DEBUG-88, 
executing instructions that contain unresolved references will produce undefined 
results. 

Figure K-2 shows the print file produced during the invocation shown above. LINK86 
does not produce a symbol table when NOBIND is in effect. 

The last step before ICE system execution is transforming the relocatable object 
module into an absolute object module with LOC86. The invocation line shown 
below would produce an object file that could be loaded and executed by an ICE-86 
or ICE-88 system: 



This invocation line shows LOC86 invoked with the default control setting. Note 
that the INITCODE control is in effect by default. 



> 




> 




> 
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iNDX B0B6 LINKER , V x.y 

INPUT FILES: ICETST.OBJ, SMALL. LIB 
OUTPUT FILE: ICETST.LNK 

CONTROLS SPECIFIED IN INVOCATION COMMAND: 
DATE: MM/DD/YY TIME: HH:MM:SS 



LINK MAP OF MODULE LOANER 
LOGICAL SEGMENTS INCLUDED: 

LENGTH ADDRESS ALIGN SEGMENT CLASS OVERLAI 



037DH W CODE CODE 

OOOOH W CONST CONST 

0192H W DATA DATA 

03FBH U STACK STACK 

OOOOH W MEMORY MEMORY 

OOOOH G ??SEG 



INPUT MODULES INCLUDED: 
ICETST.OBJCLOANER) 
SM AL L. LIB (DQ ATTACH) 
SMALL. LIB(DQCLOSE) 
SMALL.LIB(DQCREATE) 
SMALL .LIB (DQDETACH) 
SMALL .LIB(DQEXIT) 
SMALL .LIB (DQGETSYSTEMID) 
SMALL .LIB(DQOPEN) 
SMALL .LIB (DQOVERLAY) 
SMALL .LIBCDOWRITE ) 
SMALL .LIB ( SYSTEMSTACK) 



Figure K-2. LINK86 Default Print File 



Example 3: Using CREF86 

Figure K-3 illustrates a CREF86 cross-reference listing for an input list of 15 files, 
one of which contains serveral modules. The output print file pathname 1 /OUTl and 
a title for the listing were specified in the controls. Although PAGEWIDTH (PW) 
and PAGELENGTH (PL) specifications were also noted in the controls, the numbers 
specified are the same as those provided by default. 



EXAMPLE OF CROSS REFERENCE USING CREF86 



iNDX CfiEF86 V x.y 

IHPOT FILES: 1/ROOT.OBJ 1/PARSE.OBJ 1/SIGNON.OBJ 1/STATE.OBJ 1/ERROR.OBJ 1/UIILS.OBJ 1/MEMMAN.OBJ 

1/SCANNR.OBJ 1/PROCES.OBJ 1/SCUTIL.OBJ 1/LIST.OBJ 1/LSUTIL.OBJ 1/SORT.OBJ 1/0DSMA,LHK 
0/COMPAC.LIB 

OUTPUT FILE: 1/0UT1 

CONTROLS SPECIFIED: PR(1/0OT1) TKEXAMPLE OF CROSS REFERENCE USING CREF86) PW(120) PL(60) 



MODULES INCLUDED: 

FILE NAME 

1/ROOT.OBJ: 

1 /PARSE. OBJ : 

1/SIGNON.OBJ: 

1/STAIE.OBJ: 

1 /ERROR. OBJ: 

1/OTILS.OBJ: 

1/MEMMAN.OBJ: 

1/SCANNR.OBJ : 

1/PROCES.OBJ: 

1/SCUTIL.OBJ: 

1 /LIST. OBJ : 

1 /LSUTIL.OBJ : 

1/SORT.OBJ: 

1/UDSMA.LNK: 

0/C0HPAC.LI6: 



MODULE NAME(S] 

CREF86 

PARSE 

SIGNON 

NEXTSTATE 

ERROR 

UTILITIES 

MEMORYMANAGEMENT 

SCANMODULES 

PROCESSRECORDS 

SCANUTILITIES 

LISTOUTPUT 

LISTUTILITIES 

SYMBOLSORT 

OBJMAN 

DQALLOCATE 

DQDETACH 

DQGETTIME 

SYSTEMSTACK 



DQATTACH 

DQEXIT 

DQOPEN 



DQCHANGEEXTENSION 

DQFREE 

DQREAD 



DQC8EATE 

DQ6ETASGUHENI 

DQSEEK 



DQDECODEEXCEPTION 

DQGETSYSTEMID 

DQURITE 



Figure K-3 . CREF86 Cross-Reference Listing 
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CREF86 EXAMPLE OF CHOSS REFERENCE USING CREF86 

SXHEOL NAME SXHBOL TYPE 

ACCESS.PAGE ....... UNKNOWN 

ALLOCAT£ UNKNOWN 

APPENDNODE PROCEDURE NEAR 

APPENJ>bDSHNODE PROCEDURE NEAR 

ARRAXBAS& POINTER 

ATOI PROCEDURE WORD NEAR 

BTOX PROCEDURE WORD NEAR 

BUBBLESORTVARNAMES. . . . PROCEDURE NEAR 

BUMPLINECOUNT PROCEDURE NEAR 

CBECKHEADER PROCEDURE NEAR 

CHECKOVERLAY PROCEDURE NEAR 

CHECKVARTYFE PROCEDURE BYTE NEAR 



DEFINING MODULE; REFERRING HODULE(S} 



OBJHAN 

OBJHAN 

UTILITIES 

UTILITIES; 

SiMBOLSORT ; 

UTILITIES; 



UTILITIES; 
SYMBOLSORT; 
LISTUTILITIES ; 

SCANUTILITIES; 
SCANUTILITIES ; 
SCANUTILITIES; 



PARSE SCANMODULES 

LISIOUTPUT 

PARSE 

LISTUTILITIES 

LISTOUTPUT 

LISIOUTPUT 

SCANHODULES 
SCANMODULES 
PROCESSRECORDS 



PROCESSRECORDS 




CREF86 EXAMPLE OF CROSS REFERENCE USING CREF86 



UNLOAD_PAGE UNKNOWN 

VARAREAP POINTER 

VBLOCKLISThEADER WORD 

WARNING PROCEDURE NEAR 

WRIIEDATA PROCEDURE NEAR 

WRITEINITLINEBUF PROCEDURE NEAR 

WRITELINE PROCEDURE NEAR 

WRITENEWLINE PROCEDURE NEAR 

WRITETOCOMHANDBUF .... PROCEDURE NEAR 

URITETOFILE . PROCEDURE NEAR 

ZERO WORD 



MEMORIHANAGEMENT; 
PROCESSRECORDS; 

ERROR; 

LISTUTILITIES ; 
LISTUTILITIES; 
LISTUTILITIES; 
LISTUTILITIES; 
PARSE 

LISTUTILITIES; 
UTILITIES 



PROCESSRECORDS LISTOUTPUT SYMBOLSORT 
UTILITIES LISTOUTPUT SYMBOLSORT 

SCANHODULES PROCESSRECORDS 
ERROR UTILITIES LISTOUTPUT 
ERROR UTILITIES LISTOUTPUT 

LISTOUTPUT 

UTILITIES LISTOUTPUT 
ERROR LISTOUTPUT 



Figure K-3. CREF86 Cross-Reference Listing (Cont'd.) 



Example 4: Building and Using Library Files 



A library is a file that contains object modules. Libraries allow you to collect com- 
monly used pieces of software into one file. The library file can be included in a 
LINK86 invocation, and LINK86 will use the modules to resolve references. 



You can add the output from a translator, LINK86, or LOC86 to a library. The 
modules added may be relocatable or absolute; they can have unresolved references 
or be completely linked. 

Let's consider the following scenario — we have created six routines (SINE, 
COSINE, TANGENT, COSECANT, SECANT, and COTANGENT). We want to 
create a library file that will allow each routine to be linked to programs separately. 



The first step necessary to create the library is to translate each routine separately. If 
we were to output them in a single source module, the translator would translate 
them into one module with six public symbols. We could add this module to a 
library, but when we tried to link one of the routines into a program, all six would be 
included. 
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Once the routines are translated, LIB86 can be used to create a library file and add 
modules. The LIST command is used to display the contents of the library and the 
publics contained within it: 



/SYSTEMDISK/FRED/LIB86<( 



CREATE /W0RKDISK/FRE0/TRI6.LIB<cr> 
ADD /WORKDISK/FRED/SIN.OBJ , / WO R K D I S K / F R E D / C 0 S . 

TO /WORKDISK/FRED/TRIG. LIB<cr>| 
LIST /WORKDISK/FRED/TRIG. LIB PUBLICS<cr> 



J &<cr> 



/WORKDISK/FRED/TRIG. LIB 
SIN 

SINE 
COS 

COSINE 



ADD /HISDISK/SEC. LNK, / H E R D I S K / C S C . LN K , &<cr> 

/WORKDISK/FRED/COT. LNK, / WO R K D I S K / N AN C Y / T A N . LNK , &<cr> 
TO /WORKDISK/FRED/TRIG. LI B<cr> 
LIST /WORKDISK/ FRED/TRIG . LIB PUBLICS<cr> 



/WORKDISK/FRED/TRIG. LIB 
SIN 

SINE 
COS 

COSINE 
SEC 

SECANT 
CSC 

COSECANT 
COT 

COTANGENT 
TAN 

TANGENT 



EXIT<cr> 



Example 5: Creating Programs with Overlays Using OVERLAY 
Control 



The easiest way to build an 8086 program that contains overlays is with LINK86's 
OVERLAY control. Overlay modules built with this control reside in the same file 
as the root. The operating system supplies routines that will load the overlays con- 
structed in this way. See the Intellec Series IV Operating and Programming Guide. 



After the program modules that will constitute the root and its overlays are 
translated, each of the overlays and the root must be linked separately. Then the 
root and all the overlays are linked together. 



The example below shows the first step toward linking overlays — linking the root 
and all of the modules that will constitute each overlay separately. 



K-7 



Additional Information for Intellec Series IV Users 



iAPX 86,88 Family Utilities 



LINK86 /MYPR0G/0V2A.0BJ , /TH EPRO G / L I B / PRO . OB J &<cr> 
TO 0V2.LNK OVERLAY (OVER LAY2)<cr>^^^^^m^^^H 



LINK86 0V3.0BJ, 0V3A.0BJ 0 VE R LA Y ( 0 V ER LA Y3 )<c r> 



LINK86 0V4.0BJ ,0V4A.0BJ OVER LAY (OVER LAYAXc r> 



LINK86 NRO0T.OBJ,R00TA.OBJ,ROOTB.OBJ,SMALL.LIB OVER LAY (ROOT)<cr> 



Notice that all of the modules, including the root, are linked with the OVERLAY 
and NOBIND controls. The overlay name for the root is not as critical as is that for 
the overlays, since the overlay name is used when calling the loader. 

Finally, the overlays and root must be linked together. Since any one of the files 
could be the root, LINK86 requires that for the final link, the file containing the 
root must be first in the input list. During this final linkage, the OVERLAY control 

is not used: 



> 

>> 



LINK86 NROOT.LNK, 0V1.LNK, 0V2.LNK, 0V3.LN K, &<cr> 
0V4. LNK TO 1 /PROG .86 BIND<cr>| 



In this invocation, the optional BIND control is specified. The resulting object file is 
executable on a Series IV. 

Figure K-4 shows the LINKS 6 print file listing for the above invocation. 

There is nothing special about the invocation line to LOC86 when locating a file that 
contains overlays or that has been bound: 



> 

>> 



L0C86 1 /PROG. 86 TO PROG &<cr>| 
RESERVE (OH TO 77 F F H , 0 F C 000 H TO OFFFFFH)<cr> 



The RESERVE control prevents LOC86 from assigning memory addresses that the 
user wishes to reserve for the target system. Figure K-5 illustrates the printout from 
this invocation. 



INCX 6066 LINKER, V x.y 

INPUT FILES: NHUOT.LNK, 0V1.L,NK, 0V2.LNK, 0V3.LNK, OVt.LNK 
OUTPUT FILE: 

CONTROLS SPECIFIED IN INVOCATION COMMAND: 
BIND 

DATE: MM/DD/YY TIME: HH:MM:SS 



LINK MAP OF MODULE ROOT 
LOGICAL SEGMENTS INCLUDED: 

LENGTH ADDRESS ALIGN SEGMENT CLASS OVERLAY 

3CE7H G CODE CODE BOOT 

ODOOH G CONST CONST ROOT 



Figure K-4 . LINK86 Listing for Program with Overlays 
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INPUT MODULES INCLUDED: 

S0OT.LNK(]IOOT) 

OVI.LNK(PARSE) 

0V2.LNK(ILU0B) 

0V3.LNK(FICILUDE) 

0V4.LNE(FASTL0AD) 



GROUP HAP 



GROUP NAME: CGROUP 

OFFSET SEGMENT NAME 

OOOOH C0DE\C0DE\BOOT 

iCEBh CODE\CODE\P ASS1 




SIHBOL TABLE OF NODULE ROOT 



BASE 


OFFSET 


TIPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


0(2) 


251 CH 


PUB 


ACTUAL 


G(2) 


OFODH 


PUB 


ASSUMEROOTCONIRO 


G(2) 


0F22H 


PUB 


BASEFIXUPSEXIST 


G(2) 


OFOCh 


PUB 


-L 

BINDCONTHOL 


G(2) 


0D26H 


PUB 


BNODEID 


G(2) 


21IEAH 


PUB- 


BUFEASE 


G(2) 


002bH 


PUB 


CLASHNODEID 


C{2) 


0D5AH 


PUB 


COCONN 


Q(2) 


OFOOH 


PUB 


COHMEhTSCONTROL 


G(2) 


0F50H 


PUB 


CURRENTFILNUH 


G(2) 


0F1AH 


PUB 


CURRENTOVERLAINU 


G(2) 


OFUEH 


PUB 


CURRENTRECINDEX 



-M 



OVERLAY 


NAME = 


ROOT 


, MODULE NAME = ROOT 










BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


G(2) 


4A20H 


SYM 


MEMORY 


G(2) 


0002H 


SYM 


COPYRIGHT 


G(2) 


ODOOH 


SYM 


LASTNHNODEID 


G(2) 


0D02H 


SYM 


FIRSTNMNODEID 


G(2) 


0D04H 


SYM 


LASTSGNOOEID 


G(2) 


0D06H 


SYM 


FIRSISGNODEID 


G(2) 


0D08H 


SYM 


LASTIDNODEID 


G(2) 


ODOAH 


SYM 


FIRSTTDNODEID 


G(2) 


ODOCH 


SYM 


LASTEXNODEID 


G(2) 


ODOEH 


SYM 


FIRSTEXNODEID 


G(2) 


OCIOH 


SYM 


LASTGRNODEIC 


0(2) 


0D12H 


SYM 


FIRSTGRNODEIO 


G(2) 


Q014H 


SYM 


LASTOVNODEIO 


G(2) 


0D16H 


SYM 


FIRSTOVNODEID 


G(2) 


0D16H 


SYM 


LASTGNODEID 


G«2) 


GDI AH 


SYM 


FIRSTBNODEID 



OVERLAY 


NAME : 


ROOT 


, MODULE NAME = LIT 










BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


G(2) 


<tA20B 


SYM 


MEMORY 


0(2) 


003CH 


BAS 


SGNODE 


G(2) 


0F56H 


SYM 


LITBASE 


G{2) 


0F58H 


SYM 


LITID 


G(2) 


0F56H 


BAS 


LITNODE 


G(2) 


0P5AH 


SYM 


FIRSTMODEIDS 


G(2) 


0F64H 


SYM 


FIRSTNOOE 


G{2) 


OFBEH 


SYM 


CURRENTRECINDEX 


G(2) 


0F96H 


SIM 


TEMPLATE 


0(2) 


0FB9H 


SYM 


II 


Gd) 


016BH 


SXM 


"GBTLIT 


STACK 


0006H 


SYM 


INDEX 


STACK 


0004H 


SIN 


I 


0(1) 


0207H 


SXM 


SGLIT 



Figure K-4 . LINK86 Listing for Program with Overlays (Cont'd . ) 
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INDX U0ii6 LOCATOR, Vx.y 

INPUT FILE: 1/PROG.66 
OUTPUT FILE: PROG 

CONTROLS SPECIFIED IN INVOCATION COMMAND: 

TO PROG RKSERVE(OH TO 77FFH , OFCOOOH TO OFFFFFH) 
DATE: MM/DD/YY TIME: HH:MM:SS 



SYMBOL TABLE OF MODULE ROOT 



BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


1034H 


251CH 


PUB 


ACTUAL 


lOSlH 


OFODH 


PUB 


ASSUMEROOTCONTRO 


103*H 


0F22B 


PUB 


BASEFIZUPSEXIST 


lOStH 


OFOCH 


PUB 


-L 

BINDCONTROL 


1034H 


0n26H 


PUB 


BHODEID 


1034H 


24EAH 


PUB 


BUFBASE 




0028H 


PUB 


CLASHNODEID 


1034H 


0D5AH 


PUB 


COCONN 


103tH 


OFOOH 


PUB 


COMMBNTSCONIROL 


1034H 


0F50H 


PUB 


CURRENTFILNUM 



OVERLAY 


z ROOT 


, MODULE = ROOT 










BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


1034B 


4A20H 


SYM 


MEMORY 


1034H 


0002H 


SYM 


COPYRIGBT 


1034H 


ODOOH 


SYM 


LASTNMNOOEID 


1034H 


0D02H 


SYM 


FIRSTNMNODEZO 


103tH 


0D04H 


SYM 


LASTSGNOOEIO 


1034H 


0D06H 


SYM 


FIRSTSGNODEID 


103tH 


0D08H 


SYM 


LASITDNOOEIO 


1034H 


ODOAH 


SYM 


FIRSITDNODEID 


1034B 


ODOCH 


SYM 


LASTEXNODEID 


1034H 


ODOEB 


SYM 


FIRSTEXNOOEID 


10348 


0010H 


SYM 


LASIGRMODEID 


1034H 


0D12H 


SYM 


FIRSTGRMODEID 


1.034H 


0D14H 


SYM 


LASTOVHODEID 


1034B 


0D16H 


SYM 


FIKSTOVNODEID 


10348 


0D18B 


SYM 


LASTBNODEID 


1034H 


001AB 


SYM 


FIRSTBNOOEID 


1034H 


001CH 


SYM 


SGKODEID 


1034B 


0D1EH 


SYM 


GRNODEID 




OVERLAY 


: ROOT 


, MODULE = LIT 










BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


1034H 


4A20H 


SYM 


MEMORY 


1034S 


003CH 


SYM 


SGNODE 


1034H 


0F56H 


SYM 


LITBASE 


1034H 


OF58H 


SYM 


LITID 


1034H 


OF56H 


SYM 


LITNODE 


1034H 


0F5AH 


SYM 


FIRSTNODEIDS 


1034B 


0F64H 


SYM 


FIRSTNODE 


1034H 


0F8EH 


SYM 


CURRENTRECINDEX 


1054H 


OF96H 


SYM 


TEMPLATE 


1034H 


0FB9H 


SYM 


II 


0780H 


016EH 


SYM 


OETLIT 


STACK 


0006H 


SYM 


INDEX 


STACK 


0004H 


SYM 


I 


OTbOB 


0207H 


SYM 


SGLIT 



MEMORY HAP OF MODULE ROOT 



MODULE START ADDRESS PARAGRAPB 
SEGMENT HAP 



14D6B OFFSET 



START 

07800H 
0B4E8B 
0B4E8H 
0B4E8H 



STOP 



LENGTH ALIGN NAME 



0B4E6fi 3CE7H 

0F9BAH 4403H 

OBOCEH 2BE7H 

10337H 4E50H 



CODE 
CODE 
CODE 
CODE 



CLASS 

CODE 
CODE 
CODE 
CODE 



OVERLAY 

ROOT 
PASS1 
PASS2 
PIC_PASS2 



ADDRESS 
O78O0H 



1034OH 



GROUP OR SEGMENT NAME 

CGROUP 
CODE\CODE\ROOT 
C0DE\C0DE\PASS1 
C0DE\C0DE\PASS2 
C0DE\C0DE\PIC_PASS2 
CODEX CODESFASTLOAD 

DGROUP 
eONST\CONST\ROOT 
DATA\DATA\HOOT 
STACK\STACK\ 



Figure K-5 . LOC86 Listing for Program with Overlays 
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Example 6: Linking and Locating Programs witli Overlays 
Without OVERLAY Control 

It is harder to produce overlay modules without using the OVERLAY control. 
However, sometimes it is necessary to build programs in this way, for example, for 
running under an operating system that does not support overlay modules contained 
in the same file as the root module. 



But regardless of the reason, building overlays in this fashion places an extra burden 
on the programmer. He must do some of the work that would be left to LINK86 
(and LOC86) if he were to use the OVERLAY control. In the following example we 
prepare a root and two overlay modules in separate files. 

First we must compile all modules. Examples of the invocation lines are shown 
below: 



a 


|p LM 


86 


ROOT 


.SRC 


SMALL<c r>| 


1 


■ll 


■ 








9 


jP LM 


86 


0V1 ■ 


SRC S 




1 


■I 










9 


jP LM 


86 


0V2. 


SRC S 





The next step is to link the root module to resolve external symbols with a library 
and to obtain a link map: 



IT. OBJ, USEI 



B MAP<cr> 



We will need the link map for locating purposes. The link map, shown in figure K-6, 
shows the size of each segment in the root. Since the overlays are self-contained except 
for references to the root, we do not need a link map for them. The PL/M-86 listing 
files will show the size of each overlay's segments, as illustrated in figure K-7. 



INDX ttOB6 LINKER, Vx.y 

INPUT FILES: ROOT .OBJ , USER .LIB 
OUTPUT FILE: ROOT.LNK 

CONTROLS SPECIFIED IN INVOCATION COMMAND: 
MAP 

DATE: MM/DD/YY TIME: HH:MM:SS 



LINK MAP OF MODULE LOANER 
LOGICAL SEGMENTS INCLUDED: 

LENGTH ADDRESS ALIGN SEGMENT CLASS OVERLAY 



8A9BH W CODE CODE 

0381H W CONST CONST 

0291H W DATA DATA 

0030H h STACK STACK 

OOOOH h MEMORY HEMORI 



INPUT MODULES INCLUDED: 

ROOT.OBJ(ROOT) 

USER .LIB(LOADER) 

USER.LIB(EXIT) 

USER.LIB(ERROR) 

USER.LIB(TIME) 



Figure K-6. LINK86 Map for Root File 
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OVi's segment size information 

MODULE INFORMATION: 

CODE AREA SIZE = 7531H 30001D this is the CODE segment 

CONSTANT AREA SIZE = 0081H 129D this is the CONST segment 

VARIABLE AREA SIZE = 0181H 3850 this is the DATA segment 

MAXIMUM STACK SIZE = 0040H 64D this is the STACK segment 
918 LINES READ 
0 PROGRAM ERROR(S) 

END OF PL/M-86 COMPILATION 





0V2's 


s egmen t 


size information 






MODULE INFORMATION 














CODE AREA SIZE 
CONSTANT AREA SIZE = 
VARIABLE AREA SIZE = 
MAXIMUM STACK SIZE = 
918 LINES READ 
0 PROGRAM ERROR(S) 


1 B9AH 
01 01 H 
0454H 
0067H 


7066D 
2570 

1 1 08D 
1 03D 


this 
this 
this 
this 


is the 
is the 
is the 
is the 


CODE 
CONST 
DA TA 
STACK 


s egmen t 
s egmen t 

segment 
segment 


END OF PL/M-86 COMPILATION 















Figure K-7. Module Information for Overlays 



Note that the length of the root's code segment and the larger overlay's (OVl 's) code 
segment must fit within 64K. This means that the code for the overlays must be in a 
part of memory contiguous with the root (to avoid altering the CS register during 
execution). OV2's CONST and DATA segments are larger than OVl's so that the 
STACK segment must be placed to leave room for 0V2's CONST and DATA 
segments. If the overlays share the STACK and MEMORY segments with the root, 
they must be located at the same address. 



After computing the required location for the root's DGROUP and STACK, we can 
''locate the root module. The resulting file will not be executable, but it allows us to 
resolve references to the root's code and data symbols in the overlays. The following 
LOC86 invocation will leave room for the overlays' code segments and place the 
DGROUP in the first unused memory location. (In the command line below, the DS 
register is initialized to OFFCH, and the CS register is initialized to 0.) The STACK 
and MEMORY segments will be located above OV2's DATA segment: 



> 

>> 
>> 
>> 
>> 



L0C86 ROOT.LNK &<cr> 

ADDRESSES(GROUPS(CGROUP(0H),DGROUP(0FFCEH)), &<cr> 
SEGMENTS(CODE(0H),CONST(0FFCEH),STACK(10B34H))) &<cr> 
ORDER (SEGMENTS (CODE, CONST, DATA, STACK, MEMORY)) &<cr> 
SEGSIZE(STACK(100H))<cr>| 



Once the root is located, we can use it to resolve external references in the overlay 
modules. The overlay modules cannot call each other, since only one is resident in 
memory at any time. The link commands are shown below. The NOPUBLICS with 
the EXCEPT control is used to avoid conflicts when we use the located overlays to 
resolve external references in the root: 



> 

>> 



LINK86 0V1 .OBJ , PUBLICSONLY(ROOT) &<cr> 
NOPUBLICS EXCEPT (0V1C0DE , OVlDATA)<cr> 



> 

>> 



LINK86 0V2 .OBJ , PUBLICSONLY(ROOT) &<cr>i 
NOPUBLICS EXCEPT (0V2CODE, 0V2DATA)<cr> 



The PUBLICSONLY control resolves references to public symbols contained in the 
root. 
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After the overlays have been linked, they must be located. The code and data 
segments must be placed in the memory locations that were reserved when we first 
located the root. In this case the STACK and MEMORY segments must be the same 
for the overlays and the root: 



> 

>> 
>> 
>> 
>> 



L0C86 0V1 . LNK &<c r> 
ADDRESSES (GROUPS (CGROUP (OH) , DGROUP(OFFCEH) ) , S<c r>! 
SEGMENTS (CODE (8A9CH), CONST (105E0H),STACK(10B3 4H))) 
ORDER (SEGMENTS (CODE, CONST, STACK, MEMORY)) &<c r>l 
SEGSIZE(STACK(100H) )<cr>: 



> 

>> 
>> 
>> 
>> 



L0C86 0V2 . LNK &<c r>' 

ADDRESS ES( GROUPS (CGROUP (OH) ,D6R0UP (OF FC EH)) , &<cr>l 
SEGMENTS(CODE(8A9CH),CONST(105E0H),STACK(10B34H))) &<cr> 
ORDER (SEGMENTS (CODE, CONS T, DA TA, STACK, MEMORY) ) &<c r>i 
SEGSIZE(STACK(100H) )<cr>" 



The CGROUP and DGROUP base address must be specified in order to compute 
offset information. The final base address assigned to DGROUP by LOC86 will be 
rounded up to OFFDOH. 

Once the overlays are located, the root is linked and located into an executable form. 
The PUBLICSONLY control will resolve references to symbols in the overlay 
modules. Other than the addition of this input control, the LINK86 and LOC86 
command must be identical to those used previously: 



LINK86 ROOT. OBJ , USER. LIB, &<cx> 
PUBLICSONLY (0V1,0V2)<cr> 



L0C86 ROOT. LNK &<cr>' 

ADDRESSES (GROUPS (CGROUP (OH) , DGROUP (OFFCEH)) , &<cr> 
SEGMENTS(CODE(0H),CONST(0FFCEH),STACK(10B34H))) &<cr> 
ORDER (SEGMENTS (CODE, CONST, DATA, STACK, MEMORY)) &<cr> 
SEGSIZE(STACK(1 OGH) )<cr> 



The executable forms of the root and its overlay files are contained in ROOT, OVl, 
and OV2. Figure K-8 shows the resulting layout of memory. 



ROOTCODE 
SPACE 



OVERLAY 
CODE 
SPACE 



ROOT DATA 
SPACE 



OVERLAY 
DATA 
SPACE 



STACK AREA 



MtMORY 



-CS 



8A9B 
8A9C 



OFFCO 
OFFCE 



105DF 
105E0 



10B33 
10B34 



10C33 
10C34- 



■DS. SS 



Figure K-8 . Memory Organization for Example 6 
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Example 7: Linking 8089 Programs with 8086 Programs 

The process of linking and locating 8086 programs with 8089 programs that use 8089 
local memory is very similar to creating overlay modules in separate files. 

Let us consider the following example. We have created an 8086 program and two 
8089 program modules. The 8089 programs reference each other's symbols and 
public symbols in the 8086 program. In addition, one of the 8089 programs must be 
resident in 8089 local memory. 

The first step is to translate the programs. The 8089 program modules must be 
translated separately, since they will be located in different 8089 address spaces. The 
following lines illustrate the invocation lines to the translators: 



ASM86 /J0E/ASM/PR0G86.A89<cr> 



ASM89 /HARRIET/TASK1 .A89<cr> 



ASM89 /STEVE/TASK2.A89<cr> 



TASK2 should be linked and located first for 8089 local memory. This linkage will 
leave unresolved external references, but it is needed to resolve the references in 
TASKl: 



LINK86 /STEVE/TASK2 .OBJ , 8089.LIB<cr> 



L0C86 /STEVE/TASK2 . LNK R E S E R V E (1 0 0 0 0 H TO OFFFFFH)<cr> 



The RESERVE control in the locate above is a precaution to avoid exceeding 64K. 

The next step is to link and locate the object modules that will reside in the 8086's 
address space. The external references to the 8089 program module that is resident in 
8089 local memory are resolved with the PUBLICSONLY control. The invocation 
lines for linking and locating the modules are: 



LINK86 /J0E/ASM/PR0G86.0BJ , &<cr> 
8086. LIB, /HARRIET/TASK1 .OBJ , 8089. LIB, &<cr> 
PUBLICSONLY (/STEVE/TASK2) TO 86N89 . LN K<c r>| 



L0C86 86N89 . LNK<cr> 



The file 86N89 contains an absolute object module that includes PROG86 and 
TASKl . It may be loaded and executed on an 8086-based system. However, the 8089 
program to be located in 8089 local memory still has some unresolved external 
references. To resolve those references, we must relink with PUBLICSONLY and 
relocate. The invocation lines to L1NK86 and LOC86 shown below are identical to 
those used earlier — to guarantee that the references resolved earlier are not 
invalidated: 



TO OFFFFFH)<cr> 



NOTE 

The example above makes many assumptions about the 8089 and 8086 code 
that it deals with. In most practical situations it is usually necessary to use a 
more complex LINK86 and LOC86 invocation. However, the example 
above illustrates the key linking and locating principles underlying 
ASM86/ASM89 module combination. 





LIN 


K86 /STEVE/TASK2 . OBJ 


, 8089 . LIB , 


&<c r>| 




PUB 


LICS0NLY(86N89)<cr>| 
















m 


LOG 


86 /STEVE/TASK2 . LNK 


RESERVE (1 00 


OOH TO 
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Invocation Examples 



The following foldout pages contain examples of the iAPX 86,88 Family utility con- 
trols and commands. The examples illustrate conventions you are likely to encounter 
while using the Series IV. They may be used in conjunction with syntax specifica- 
tions given: 

• In Chapter 2 for LINK86 

• In Chapter 3 for CREF86 

• In Chapter 4 for LIB86 

• In Chapter 5 for LOC86 

When using the directions in these chapters, fold out the page in this appendix con- 
taining examples of the command or control you are interested in. 

The following is a sample Series IV OH86 invocation: 



/SYSTEM/CHARLIE/0H86 /MYCODE/DONE TO / M Y C 0 D E / F I N I . H E X < c r> 
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Comments 

This example defines two-public symbols, VARONE 
and VARTWO, with absolute addresses 50H and 
2000H, respectively. 

In this example, the root file is RTFILE, and 
SYSTEM/LIB1, /SYSTEMB/LIB2, LIB1, and LIB2 are 
library files. 



This line creates an LTL module. The output object 
file is WORK/TEST with no extension. 

This example specifies default to avoid ambiguity. 



LINES is the default, so it need not be specified. 



This MEMPOOL example will increase the minimum 

dynamic memory requirements by 20H bytes, and by 
default the maximum size will increase, if necessary, 
to equal the minimum. 

The minimum dynamic memory requirement is 100H. 
The maximum dynamic memory requirement is 
300H. 



Control 



ASSIGN 
ASSUMEROOT 



BIND/NOBiND 
COMMENTS/NOCOMMENTS 

FASTLOAD/NOFASTLOAD 

INITCODE 
LINES/NOLINES 

MAP/NOMAP 



MEMPOOL 



> 

>> 
>> 

> 

>> 
>> 
>> 

> 

>> 
>> 

> 

>> 
>> 

> 

>> 

> 

>> 
> 
> 
> 

>> 
> 

>> 



SERIES IV LINK86 EXAMPLES 
Examples 



LINK86 SYS/FILE1, WORKD I S K/ F I LE2 , &<cr> 
FILE3 ASS IGN (VARONE (50H) . &<cr> 
VARTWO( 2000) )<cr>| 



LINK86 CHARLES/R00T1 .OBJ , &<cr> 
R00T2.0BJ, SYSTEM/LIB1, &<cr> 
/SYSTEMB/LIB2 TO RTFILE &<cr> 
OVERLAY<cr>i 



LINK86 0V11 .OBJ , 0V1 2 .OBJ , LIB1 , &<cr> 
LIB2 TO OVl .OBJ OVERLAY &<cr> 
ASSUMEROOT(RTFILE)<cr> 



LINK86 0V21.0BJ, W0RK/0V22 . OB J , &<cr> 
SYSTEM/LIB1, / S Y S T E M B / L I B 2 TO &<cr>i 
0V2.0BJ OVERLAY A S S UM E R 00 T ( R T F I L E X c r> 



LINK86 RTFILE, 0V1.0BJ, 0V2.0BJ &<cr> 
TO PR0G<c r>| ' ' 



S Y S T E M / L I N K86 WO R K / T E S T . 0 B J , &<cr> 
USER. LIB BIND PRINT<cr> 



SYSTEM/LINK86 WORK/GEN. OBJ NOBIND<cr> 



LINK86 SOURCE. OBJ NOCOMMENTS <c r> 



LINK8 


6 PROG. 


OB 


J TO 


TE 


MP. TEST &<cr>| 


COMME 


NTS<c r> 


■ 










SYSTE 
USERA 


M/LINK8 
/LIB1 , 


6 

LI 


PROG. 
B2 BI 


OB 
ND 


J, &<cr>^^m 

FASTLOAD<c r>| 



LINK86 MYDISK/PLM/MYPROG INITCODE<cr> 





LIf 




16 


RUN. OBJ f 


^OLINES<c r>| 




HI 


■ 


■ 








LIf 




16 


TEST. OBJ 


LINES<cr>l 



/SYSTEM/LINK86 WO R K / T E S T E R . 0 B J &<cr> 
MAP<cr> 



/SYSTEM/LINK86 /WORK/MAIN . OBJ , &<c r> 
/WORK/USER. OBJ , PUBLICSONLY &<cr> 
(8089. LOO NOMAP<cr> 



SYSTEM/LINK86 T E D /T E S T . OB J , S<cr^> 
USER. LIB, PASCAL. LIB BIND &<cr> " 
MEMPOOL(+20H)<cr> 



> 

>> 



LINK86 TESTED. OBJ MEM POOL S<cr> 
(100H,+200H) BIND<cr> 
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Comments 

The LINK86 output module will have the name 
specified in parentheses in the control. 



This example removes all debug and public records 
from the object file. 



The EXCEPT in the NOPUBLICS overrides the 
PURGE. 



This use of ORDER specifies the order of segments 
for two groups. 



This example will create an overlay record, and the 
name of the overlay will be 0VERLAY1 . 



First the constituent files must be linked to form 
overlays. 

The print file is W0RKDISK/TEMP1.MP1. 

The print file is PR0G.MP1. 
Theprintfile is THE. MAP. 



This example removes information about line 
numbers, local symbols, and comments from the 
print file. 

This statement removes all but the segment informa- 
tion and error messages from the print file. 



Control 

NAME 



OBJECTCONTROLS 



ORDER 



OVERLAY/NOOVERLAY 



PRINT/NOPRINT 



PRINTCONTROLS 



SERIES IV LINK86 EXAMPLES 
Examples 



/SYSTEM/LINK86 WOR K/TOM . OB J , &<c r> 
/SYSTEM/SYSTEM. LIB NAME &<cr>HHB 
(THIS IS A VERY LONGSNAMEXc r>^H 



,LINK86 TOM/FINAL, MARY/USE R. LIB, &<cr> 
EVERYONE/SYSTEM . LIB S <c r>BHH|HHHH| 
OBJECTCONTROLSCPURGEXc r>^^^^^^H 



,LINK86 PASCL1.06J S<c7>|^^^^^H 

iOBJECTCONTROLS (PURGE, NOPUBLICS S <c r> 
EXCEPT (START, DATA1, DATA2))<cr>BB| 



LINK86 FILE1, FILE2, FILE3 TO &<cr> 
0V1.LNK OVERLAY (OVER LAY1 )<c r>HHB| 



LINK86 FILE4, FILE5, FILE6 TO &<cr> 
0V2.LNK 0VERLAY(0VERLAY2) <cr>BHH| 



SYSTEM/LINK86 MY D I S K /T EMP . OB J &<cr> 
BIND PRINTCONTROLS (NOLINES , &<cr>M 
NOCOMMENTS, N 0 S Y M B 0 L S )<c r M 

nNK8^A^ASC^^^^<^^^^^H 

lPRINTCONTROLS(PURGE)<c r>H^^^^H 
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Comments 

Public information concerning only DATA1, DATA2, 
LABEL3, and PR0C4 is placed in the object file and 
print file. 

All public symbol information will be included in both 
the print file and the output file. 



This example will produce a file containing only the 
absolute public symbol records from 8089. LOG. The 
object file will be8089.LNK. 

This example will resolve the references in 
WORK/PLM/ROOT.OBJ to absolute public symbols 
in the separately linked and located overlays 
W0RK/PLM/0VL1 and W0RK/PLM/0VL2. 

This example produces an object file containing no 
debug or public information. 

This confirms that the line and symbol information 
should be kept in the print file. 

This will change the translator-assigned name 
CGROUP to THE@CODE. A subsequent linkage 
would not combine THE@CODE with a group named 
CGROUP. 

This example changes the name of the CODE group 
to CGROUP. 

This tells the loader that 15FFH bytes of code is ths 
maximum requirement for MEMORY. The new max- 
imum size of MEMORY is 35FFH. 



This example increments MEMORY'S minimum size 
by 1FFH (7951 D) bytes. The maximum size of 
MEMORY is equal to the old minimum size plus 3FEH 
(15902D). 

The local symbol records will be included in the 
object file. 

Purge is a shorthand for NOSYMBOLS, NOCOM- 
MENTS, NOPUBLICS, NOTYPE, and NOLINES. 

SYMBOLCOLUMNS has no effect, since BIND was 
not specified. 

The symbol table will be printed on a line printer. 



WORK/LIBMOD.OBJ will retain its type information. 



SERIES IV LINK86 EXAMPLES 



Control Examples 



PUBLICS/NOPUBLICS > 

>> 
>> 



> 

>> 
>> 



PUBLICSONLY 



ILINK86 TEST. OBJ, USER. LIB &<c7>^^H 
INOPUBLICS EXCEPT (D ATA1 , DATA2 , &<c r> 
|LABEL3, PR0C4XC r>— MMMM 



SYSTEM/LINK86 WORK/TEMP . OBJ ,&<cr>HB 
SYSTEM/SMAL L. LIB, WO R K / U S E R . L I B &<cr> 
P U B L I C S < c r > ■^■■^■■■■■■■■1 



LINK86 WORK/PLM/ROOT.OBJ, &<cr>| 
,PUBLICS0NLY(W0RK/P LM/OVL1, S<cr> 
W0RK/PLM/0VL2) <c r>HHHHHIi^H 



LINK86 FINAL. OBJ PR I NTCQNTRO LS &<cr> 
(NOPURGEXc ^^mmmmmmmmmmmmi^^^mmmm 



LINK86 PLMPRG.OBJ RENAME GROUPS S<cr> 
(CGROUP TO TMESCODE) <c r>HH|HHl 



PURGE/NOPURGE 



> 

>>! 



RENAMEGROUPS > j 

>> 



SEGSIZE 



LINK86 ASMPRG.OBJ &<cr>| 
RENAMEGROUPS (CODE TO C6R0UP)<cr> 



SYSTEM/LINK86 WO R K / G EO R G E . 0 B J , S<cr> 
WORK/PETER/USER. LIB, &<cr>i 
SYSTEM/SYSTEM. LIB BIND SEGSIZE &<cr> 
(MEMORY (1 5FFH,+2000H) ) <cr>i 



LINK86 PROJCT.OBJ, &<cr> 
REST. LIB SEGSIZE (MEMORY &<cr> 
( + 1 FF,+1 FF) )<cr> 



LINK^ 


56 TE^ 


IP .01 


3J, 


USER. LIB 


S<c r>| 


NOSY^ 


^BOLS 


SYM[ 


30LJ 







SYSTEM/ LINK86 U S E R / T E S T . 0 B J , &<cr> 
SYSTEM/USER . LIB P U R G E < c r>HH|BH 



SYMBOLS/NOSYMBOLS 



> 

>> 



> 

>> 



SYMBOLCOLUMNS 



LINK86 TEST. OBJ S Y M B 0 L C 0 LUM N S (1 X c r> 



LINK86 ROOT.LNK, 0V1.LNK, &<cr>^^M 

0V2.LNK, PUBLICSONLY (8089) &<cr>^H 
SYMBOLCOLUMNS (4) BIND PR I NT ( : LP : )<c r> 



TYPE/NOTYPE 



SYSTEM/LINK86 WORK/LIBMOD.OBJ TYPE<cr> 
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Comments 

The cross-reference listing will have 35 lines on each 
page. 

The cross-reference listing will be 100 characters 
wide maximum per page. 

The pathname of the print file will be MYFILE. 



The message in the TITLE control must be placed on 
one line. If the message contains special characters, 
it must be enclosed in single quotes ('). 



SERIES IV CREF86 examples 



Control 



PAGELENGTH 
PAGEWIDTH 
PRINT 
TITLE 



Examples 



CREF86 FILE1 , FILE. LIB &<cr> 
PAGELENGTH (35)<c r> 



SYSTEM/CREF86 W0RK/PR06, &<cr> 
SYSTEM/LIBCMODI) PAGEWIDTH(100)<cr> 



CREF86 FI LES (M0DULE1 , &<c r> 
M0DULE2) PRINT (MY FI LEXc r>i 
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Comments 

Three object files are added to the USER. LIB. 



Three modules from the library WORK/LIB. ABC are 
added to SYSTEM /PROG.TOM. 



This command will produce an empty library file 
called SYSTEM/TOMS. LIB. 



Four modules are deleted from the library USER. LIB. 



SERIES IV LIB86 EXAMPLES 



Control 



ADD 



CREATE 



Examples 



ADD SIN, COS, TAN TO USER.LIB<cr> 



* 



ADD WORK/LIB. ABCCMODI , M0D2, &<cr> 
M0D3) TO SYSTEM/PROG. TOM<cr>: 



CREATE SYSTEM/TOMS . LIB<c r> 



DELETE 



EXIT 
LIST 



CREATE WORK/USER. LIB<cr> 



* 



DELETE USER. LIBCTEMPI , TEMP3, &<cr> 
"TEMP TMP, TEST'?)<cr> 



* 



DELETE WORK/IO.LIB(f LOPPY, CRT, &<ci:^> 
PAPER TAPE)<cr> 



EXIT<cr> 



LIST USER. LIB<cr> 



USER 
IE 
TE 
EX 
MA 
LO 



.LIB 
MP 

ST 
EC 
IN 
OP 



LIST USER. LIB(TEMP,TEST)<cr> 



USER 
TE 
TE 



.LIB 

MP 

ST 



LIST USER. LIB, TEMP. LIB<cr> 



USER 
TE 
TE 
EX 
MA 
LO 

TEMP 
MO 
MO 
MO 



.LIB 

MP 
ST 
EC 
IN 
OP 

.LIB 

DULE1 
DULE3 
DULETC 
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Comments 



If SEG1 is byte allgnable, it will be located at 15FFH. If 
SEG2 is byte or word alignable, it will be at 4F5AH . 



Address assignment of groups, segments, and 
classes can be in any order, unless they are 
absolute. 



A long jump to GO will be placed at location 
OFFFFOH. 



The initialization code is placed at address 32768 
decimal (8000H). 



No initialization code will be produced. 



Lines is the default, so it need not be specified. 



This statement removes all debug records from the 
object file, but keeps the information in the print file. 

NOPUBLICS is implied by PURGE, but PUBLICS 
overrides it. 



SEG@A of GLASS1 will be the first relocatable seg- 
ment located. SEG@B will be the next, followed 
immediately by any other segments contained within 
CLASS1. The extra segments in CLASS1 (and all of 
the segments in CLASS2) are located in the order in 
which they are encountered. Finally, the list in the 
SEGMENTS subcontrol is handled. 



SERIES IV LOC86 EXAMPLES 



Control 



ADDRESSES 



BOOTSTRAP 



COMMENTS/NOCOMMENTS 



INITCODE/NOINITCODE 



Examples 



L0C86 COME. LNK TO WENT &<cr> 
ADDRESSES (SEGMENTS (SEG1\CLASS2\&<cr> 
0VERLAY3 (1 5FFH) , S E G 2 ( 4 F 5 A H ) )<c r >r^ 



L0C86 1ST. LNK TO LOCIST.RDY &<cr> 
ADDRESSES (SEGMENTS &<cr> 
(SEG1\CLASS1 (23H)), &< 
GROUPS(CGROUP(00H) , &< 
DGROUPdOOOOH)), &<cr> 
CLASSES (MEMORY (1 5000H) ) ) <c r> 



SYSTEM/L0C86 WORK/TEST . LN K &<cr > 
START(GO) BOOTSTRAP<cr> 



iOCSb SOURCE. LNK NOCOMMENTS<c r> 



L0C86 TEMP. LNK COMMENTS<cr> 



SYSTEM/L0C86 H I S D I S K/ P LM / F OR K . LN K &<cr> 
INITC0DE(32768)<cr> 



LINES/NOLINES 



MAP/NOMAP 



L0C86 TEST. LNK NOIN ITCODE<c r> 



L0C86 RUN. LNK NOLINES<cr> 



L0C86 TEST.LNK<cr> 



SYSTEM/L0C86 WORK/TESTER . LNK MAP<cr> 



NAME 



OBJECTCONTROLS 



ORDER 



L0C86 GONE. LNK TO HERMAF.OVY NOMAP<cr> 



L0C86 SHORT. LNK NAME &<c r> 
(THIS IS A VERY LONG MODU LESNAME . )<c r> 



L0C86 UPWARD. LNK OBJECTCONTROLS &<cr> 
(NOLINES,NOCOMMENTS,NOSYMBOLS)<cr> 



L0C86 PASCL1.LNK OBJECTCONTROLS &<cr> 
(PURGE, PUBLICS)<cr> 



L0C86 SPCSEQ.LNK ORDER &<cr> 
(CLASSES (CLASS1 (SEGSA, SEGSB), &<^r> 
CLASS2) , SEGMENTS &<cr> 
(SEG1 \CLASS3\0VERLAY1 , &<cr> 
SEG22,SEG10\CLASS5) )<cr> 
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Comments 

The print file is TEIVIPI .MP2. 

The print file is W0RK/INTERP.MP2. 

The print file is MAP. 

Information about line numbers is removed from the 
print file. 

All but the segment information is removed from the 
print file. 

No public information is included in the output files 
(PRIVAT.MP2and PRIVAT). 

All public symbol information will be included in both 
the print file and the output file. 

The object file contains no public or debug informa- 
tion, and the symbol table does not appear in the 
print file. 

The line and symbol information will be kept in the 
print file and object file. 

This control reserves the high order 64K of memory. 



A 200H and a 100H section of memory at the top and 
bottom of memory are reserved. 



The size of segment MEMORY will be increased by 
2000 bytes. 

The size of segment FREUD will be decreased by 511 
bytes. 

The new segment size for XENDA is 7770 bytes. 



AUTO will start at IGNITION. 

HALTS will start at location 200H. 

This statement will include the local symbol records 
in the object file and the symbol information in the 
print file. 

PURGE is a shorthand for NOSYMBOLS, NOCOM- 
MENTS, NOPUBLICS, and NOLINES. 

The symbol table will be printed on a line printer. A 
line printer line can hold a four-column symbol table. 



Control 



PRINT/NOPRINT 



PRINTCONTROLS 



PUBLICS/NOPUBLICS 



PURGE/NOPURGE 



SERIES IV LOC86 EXAMPLES 
Examples 



L0C86 PROG. INK TO TEMPI. TST PRINT<cr> 



SYSTEM/ LOC 86 WO R K / 1 N T E RP . L N K <c r> 



L0C86 PROG. LNK PR I NT ( MAP )<c r> 



L0C86 LINEAR. LNK S<cr>| 
PRINTCONTROLS (NOLINES )<cr> 



SYSTEM/HI&/L0C86 PLM/PROG.LNK &<cr> 
PRINTCONTROLS (PURGE)<cr> 



L0C86 PRIVAT. LNK NOPUB L I CS <c r> 



L0C86 TEXT. LNK NOPUBLICS PUBLICS<cr> 



L0C86 PR0J5,ANK PURGE<cr> 



RESERVE 



SEGSIZE 



START 



SYMBOLS/NOSYMBOLS 



L0C86 80209. LNK PURGE &<cr> 
PRINTCONTROLS (NOPURGE)<cr>" 



L0C86 LOWMEM.LNK &<cr> 
RESERVE (OFOOOOH TO OFFFFFH)<cr> 



SYSTEM/L0C86 A S M / H U G 0 S . IM K &<cr> 
RESERVECOOH TO 0200H, &<cr> 
OFFFOOH TO OFFFFFH)<cr> 



L0C86 GROW. LNK SEGSIZE &<cr> 
(MEMORY (+2000) )<c r> 



L0C86 SHRINK. LNK SEGSJ^ &<c_r> 
(FREUD(-1 FFH) )<cr> 



a 


SYSTEM/LOC? 
SE6S IZE (XE^ 


16 
JD/ 




1 




■ 




m 


L0C86 AUTO. 




J^^^^^GNmONK^l 



L0C86 HALTS. LNK START(OOH, 200H)<cr> 



/SYS/L0C86 GERTIE/GESTA. LNK SYMB0LS<cr> 



L0C86 TEST. LNK PURGE<c r> 



SYMBOLCOLUMNS 



> 

>> 



L0C86 LINKED. LNK S YMBO LCOLUMNS (4) &<cr> 
PRINT(:LP:)<cr> 
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absolute object file formats, A-1 

absolute object modules, 1-2 

AD, 5-3 

address, 
in ADDRESSES control, 5-3 
in ASSIGN control, 2-4 
in INITCODE control, 5-6 
in RESERVE control, 5-16 

ADDRESSES, 5-3 

addressing, 
A, 4-2 

absolute, 1-4, 2-4 

ADD, 4-2 

8086, 1-5 

relative, 1-4 
alignment, 

boundaries, 1-8 

of segments, 1-7 
AR, 2-5 
AS, 2-4 
ASSIGN, 2-4 

available memory, effect of, C-1 



Bl, 2-6 

BIND, 2-6 

BOOTSTRAP, 5-4 

bound modules (seeLTL modules) 

BS, 5-4 



C,4-3 

class, 8086, 1-9 
CLASSES, 5-3, 5-11 
class name, 

in ADDRESSES control, 5-3 
in ORDER control, 
LINK86, 2-15 
LOC86, 5-11 
in SEGSIZE control, 
LINK86, 2-23 
LOC86, 5-17 
CM, 2-7 
COMMENTS, 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
LINK86 control, 2-7 
LOC86 control, 5-5 
control summary, 
CREF86, E-1 
L1B86, F-1 
L1NK86, D-1 
LOC86, G-1 
CREATE, 4-3 



CREF86, 
controls, 

PAGELENGTH, 3-3 

PAGEWIDTH, 3-4 

PRINT, 3-5 

TITLE, 3-6 
control summary, 3-2 
error messages, E-1 
in development process, 1-1 
input, 3-1 
invocation, 3-2 

iRMX 86 invocation examples, J-19/J-20 
output, 3-1 
print file, 3-7 

Series III invocation examples, I-23/I-24 
Series IV invocation examples, K-23/K-24 
use of libraries, 1-3 

cross-reference listing, 3-7 

CS, 5-3, 5-11 

D, 4-3 

data records, 8086, A-3 
debug records, 

L1NK86, 2-21 

LOC86, 5-15 
DELETE, 4-3 

E, 4-4 

ENDREC, A-7 
error messages, 
CREF86, E-1 
LIB86, F-1 
L1NK86, D-2 
LOC86, G-2 
OH86, H-1 
examples, iRMX 86 
invocation, 

CREF86, J-19/J-20 

LIB86, J-21/J-22 

LINK86, J-13/J-14 

LOC86, J-23/J-24 

OH86, J-12 
program development 

CREF86, J-3 

LIB86, J-5 

LINK86, J-6, J-9 

LOC86, J-10 
examples. Series III, 
invocation, 

CREF86, 1-23/1-24 

LIB86, 1-25/I-26 

LINK86, 1-17/I-18 

LOC86, 1-27/I-28 

OH86, 1-15 
program development, 

CREF86, 1-6 

L1B86, 1-7 

LINK86, 1-2, 1-5, 1-8, 1-ll, 1-14 
LOC86, 1-4, 1-5, 1-8, 1-12 
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examples, Series IV 
invocation, 

CREF86, K-23/K-24 

LIB86, K-25/K-26 

LINK86, K-17/K-18 

LOC86, K-27/K-28 

OH86, K-15 
program development, 

CREF86, K-5 

LIB86, K-6 

LINK86, K-2, K-4, K-8, K-11, K-12, 
K-14 

LOC86, K-4, K-8, K-12 
EXIT, 4-4 
external references, 

cross-reference listing, 3-7 

definition of, 1-2 

resolution of, 1-3 

FASTLOAD, 2-8 
FL, 2-8 

GR, 5-3 

group, 
addressing, 1-9 
8086, 1-9 

group map, 2-27 

group name, 
in ADDRESSES control, 5-3 
in LINK86 ORDER control, 2-15 
in LINK86 RENAMEGROUP control, 2-: 

GROUPS, 5 3 

hexadecimal-decimal conversion, B-1 
hexadecimal object file format, 
conversion to, 6-1 
records of, 
data. A- 13 
end of file, A-15 
extended address, A-12 
start address, A-14 

IC, 

LINK86, 2-9 

LOC86, 5-6 
INITCODE, 

LINK86, 2-9 

LOC86, 5-6 
initialization code, 

LINK86, 2-9 

LOC86. 5-6 
input list control, 2-20 
iRMX 86 information, 

continuation-line characters, J-2 

environmental conditions, J-1 

examples, J- 12 

file-naming conventions, J-2 

generation of code, J-3 

invocation, J-1 

memory requirements, J-1 

program development examples, J-3 

prompts, J-2 

related publications, J-2 



LHEADR, A-6 
LI, 

LINK86, 2-10 
LOC86, 5-7 
LIB86, 

commands, 

ADD, 4-2 

CREATE, 4-3 

DELETE, 4-4 

EXIT, 4-5 

LIST, 4-6 
command summary, 4-1, F-1 
error messages, F-1 
in development process, 1-1 
input, 4-1 
invocation, 4-1 

iRMX 86 invocation examples, J-21/J-22 
Series III invocation examples, I-25/I-26 
Series IV invocation examples, K-25/K-26 
librarian (see LIB86) 
libraries, 
adding to, 4-2 
creating, 4-3 
deleting from, 4-4 
listing contents of, 4-6 
use of by CREF86, 1-3 
useofbyLINK86, 1-3 
line number control, 
LINK86, 2-10 
LOC86, 5-7 
LINES, 
in OBJECTCONTROLS, 

L1NK86, 2-14 

LOC86, 5-10 
in PRINTCONTROLS, 

L1NK86, 2-18 

LOC86, 5-13 
LINK86, 2-10 
LOC86, 5-7 
link map, 2-27 
linkage (see L/N/s:^(J) 
LINK86, 
and LOC86, 1-4 
controls, 

ASSIGN, 2-4 

ASSUMEROOT, 2-5 

BIND, 2-6 

COMMENTS, 2-7 

FASTLOAD, 2-8 

INITCODE, 2-9 

LINES, 2-10 

MAP, 2-11 

MEMPOOL,2-12 

NAME, 2-13 

NOBIND, 2-6 

NOCOMMENTS, 2-7 

NOFASTLOAD, 2-8 

NOLINES, 2-10 

NOMAP, 2-11 

NOOVERLAY, 2-16 

NOPRINT, 2-17 

NOPUBLICS, 2-19 

NOPURGE, 2-21 
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NOSYMBOLS, 2-24 
NOTYPE, 2-26 
OBJECTCONTROLS, 2-14 
ORDER, 2-15 
OVERLAY, 2-16 
PRINT, 2-17 

PRINTCONTROLS, 5-12 

PUBLICS, 2-19 

PUBLICSONLY, 2-20 

PURGE, 2-21 

RENAMEGROUPS, 2-22 

SEGSIZE, 2-23 

SYMBOLCOLUMNS, 2-25 

SYMBOLS, 2-24 

TYPE, 2-26 
control summary, 2-2, D-1 
erorr messages, D-2 
in development process, 1-1 
input, 1-4, 2-1, 2-20 
invocation, 2-1 

iRMX 86 invocation examples, J-13/J-14 
output, 1-4, 2-1 
print file, 2-27 
segment combination, 1-7 
Series III invocation examples, I-17/I-18 
Series IV invocation examples, K-17/K-18 
use of libraries, 1-3 
LIST, 4-6 

load-time-locatable module (seeLTL module) 
location (see LOC86) 
location algorithm, 

for modules with overlays, 5-25 

for segments, 5-24 

LOC86, 
and LINK86, 1-4 
controls, 

ADDRESSES, 5-3 

BOOTSTRAP, 5-4 

COMMENTS, 5-5 

INITCODE, 5-6 

LINES, 5-7 

MAP, 5-8 

NAME, 5-9 

NOCOMMENTS, 5-5 

NOINITCODE, 5-6 

NOLINES, 5-7 

NOMAP, 5-8 

NOPRINT, 5-12 

NOPUBLICS, 5-14 

NOPURGE, 5-15 

NOSYMBOLS, 5-19 

OBJECTCONTROLS, 5-10 

ORDER, 5-11 

PRINT, 5-12 

PRINTCONTROLS, 5-13 

PUBLICS, 5-14 

PURGE, 5-15 

RESERVE, 5-16 

SEGSIZE, 5-17 

START, 5-18 

SYMBOLS, 5-19 

SYMBOLCOLUMNS, 5-19 
control summary, 5-2, G-1 
error messages, G-2 



in development process, 1-1 
input, 1-4, 5-1 
invocation, 2-1 

iRMX 86 invocation examples, J-23/J-24 
output, 1-4, 5-1 
print file, 5-21 

Series III invocation examples, 1-27/ 1-28 

Series IV invocation examples, K-27/K-28 
LTL controls, 

BIND, 2-6 

FASTLOAD, 2-8 

MEMPOOL, 2-12 

ORDER, 2-15 

PRINTCONTROLS, 2-18 

SEGSIZE, 2-23 

SYMBOLCOLUMNS, 2-25 
LTL modules, 1-2, 1-4, 1-10 



MA, 

LINK86,2-11 

LOC86, 5-8 
MAP, 

L1NK86,2-11 

LOC86, 5-8 
maximum-size, 

in MEMPOOL control, 2-12 

in SEGSIZE control, 2-23 
memory, 

configuration with overlays, 1-10 

8086, 1-5 
memory map, 5-23 
memory requirements controls, 

LINK86 MEMPOOL, 2-12 

SEGSIZE, 
LINK86, 2-23 
LOC86, 5-17 
MEMPOOL, 2-12 
minimum-size, 

in MEMPOOL control, 2-12 

in SEGSIZE control, 2-23 
MODEND, A-9 
module attributes, A-2 
module identification, A-2 
module name, 

in LINK86 NAME control, 2-13 

in LOC86 NAME control, 5-9 
MP, 2-12 



NA, 

LINK86, 2-13 

LOC86, 5-9 
NAME 

LINK86, 2-13 

LOC86, 5-9 
naming output module, 

LINK86, 2-13 

LOC86, 5-9 
NOBl, 2-6 
NOBIND, 2-6 
NOCM, 2-7 
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NOCOMMENTS, 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86,2-18 
LOC86, 5-13 
L1NK86, 2-7 
LOC86, 5-5 
NOFASTLOAD, 2-8 
NOFL, 2-8 
NOIC, 5-6 
NOINITCODE, 5-6 
NOLI. 

LINK86, 2-10 
LOC86, 5-7 
NOLINES, 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
LINK86, 2-10 
LOC86, 5-7 
NOMA, 
LINK86, 2-11 
LOC86, 5-8 
NOMAP 
LINK86, 2-11 
LOC86, 5-8 
NOOV, 2-16 
NOOVERLAY, 2-16 
NOPL, 
LINK86, 2-19 
LOC86, 5-14 
NOPR, 

LINK86, 2-17 
LOC86, 5-12 
NOPRINT, 
LINK86, 2-17 
LOC86, 5-12 
NOPU, 

LINK86, 2-21 
LOC86, 5-15 
NOPUBLICS, 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86,2-18 
LOC86, 5-13 
LINK86,2-19 
LOC86, 5-14 
NOPURGE, 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
LINK86, 2-21 
LOC86, 5-15 



NOSB, 
LINK86, 2-24 
LOC86, 5-19 
NOSYMBOLS, 

in OBJECTCONTROLS, 
LINK86,2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86,2-18 
LOC86, 5-13 
LINK86, 2-24 
LOC86, 5-19 
NOTY, 2-26 
NOTYPE, 
in OBJECTCONTROLS, 2-14 
in PRINTCONTROLS, 2-18 
LINK86, 2-26 



OBJECTCONTROLS, 

LINK86, 2-14 

LOC86, 5-10 
object module format, 1-4, A-1 
OC, 

LINK86, 2-14 

LOC86, 5-10 
OD, 

LINK86, 2-15 

LOC86, 5-11 
offset, 5-18 
OH86, 

error messages, H-1 

in development process, 1-1 

input, 6-1 

invocation, 6-1 

iRMX 86 invocation examples, J- 12 
output, 6-1 

Series III invocation example, 1-15 
ORDER, 

LINK86, 2-15 

LOC86,5-ll 
OV, 2-16 
OVERLAY, 2-16 
overlay controls, 

ASSUMEROOT,2-5 

OVERLAY, 2-16 
overlay, 8086, 1-10 
overlay name, 

ADDRESSES, 5-3 

LINK86 ORDER control, 2-15 

LINK86 OVERLAY control, 2-16 

SEGSIZE, 
LINK86, 2-23 
LOC86, 5-17 
overlays and location, 5-25 
OVLDEF, A-7 



PAGELENGTH, 3-3 
PAGEWIDTH, 3-4 
paragraph, 5-18 
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pathname, 

in ASSUMEROOT control, 2-5 

in LIB86 commands, 4-1 

in PRINT control, 
L1NK86, 2-17 
LOC86, 5-12 

in PUBLICSONLY control, 2-20 
PC, 

LINK86, 2-18 

LOC86, 5-13 
PEDATA, A-10 

performance-memory relationship, C-1 
PIC, 1-10 
PIDATA, A-10 
PL, 

CREF86, 3-3 

LINK86, 2-19 

LOC86, 5-14 
PO, 2-20 

position-independent code (see PIC) 
PR, 
CREF86, 3-5 
L1NK86, 2-17 
LOC86, 5-12 
PRINT, 
CREF86, 3-5 
LINK86, 2-17 
LOC86, 5-12 
PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
print file, 
controls, 
CREF86, 3-2 
LINK86, 2-18 
LOC86, 5-13 
CREF86, 
cross-reference information, 3-8 
header, 3-7 
moduie list, 3-8 
warnings, 3-7 
LINK86, 
ei.or messages, 2-30 
group map, 2-28 
header, 2-27 
link map, 2-11, 2-27 
symbol table, 2-29 
LOC86, 
errors and warni.igs, 5-24 
memory map, 5-23 
symbol table, 5-21 
print file name, 
LINK26, 2-17 
LOC86, 5-12 
program development, 1-1 
PU. 
LINK86, 2-21 
LOC86, 5-15 
PUBLICS, 
in LIB86 LIST control, 4-6 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 



in PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
L1NK86, 2-19 
LOC86, 5-14 
PUBLICSONLY, 2-20 
public symbol, 1-2, 5-18 
public symbol cross-references, 3-7 
public symbol records, 
in libraries, 4-6 
LINK86, 

PUBLICS/NOPUBLICS, 2-19 
PUBLICSONLY, 2-20 
LOC86, 5-14 
PURGE, 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
LINK86, 2-21 
LOC86, 5-15 
PW, 3-4 



record formats, 
end, A-7 

L-module header, A-6 

module end, A-9 

overlay definition, A-7 

physical enumerated data, A-10 

physical iterated data, A-10 

register initialization, A-8 

R-module header, A-6 

sample, A-4 

T-module header, A-5 
record syntax, A-3 
REGINT, A-8 

register initialization, 2-9, 5-6, A-8 
relocatable object module, 1-2 
relocation {see LOC86) 
RENAMEGROUPS, 2-22 
RESERVE, 5-16 
RG, 2-22 
RHEADR, A-6 
RS, 5-16 



SAMREC, A-4 
SB, 

LINK86, 2-24 

LOC86, 5-19 
SC. 

LINK86, 2-25 

LOC86, 5-20 
segment, 

alignment, 1-7, 2-28 

combining, 1-8 
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8086, 1-6, A-2 

locating, 1-8, 5-24 

memory, 1-8, 2-23, 5-17 

ordering, 

LINK86, 2-15 
LOC86, 5-11,5-24 

stack, 1-8 
segment addressability, A-2 
segment location algorithm, 

absolute segments, 5-24 

relocatable segments, 5-25 

segment ordering, 5-24 
segment map, 2-29 
segment name, 

in ADDRESS control, 5-3 

in ORDER control, 
LINK86, 2-15 
LOC86, 5-11 

in SEGSIZE control, 
LINK86, 2-23 
LOC86, 5-17 
SEGMENTS, 5-3 
SEGSIZE, 

LINK86, 2-23 

LOC86, 5-17 
Series III information, 

continuation-line characters, I-l 

environmental considerations, I-l 

ISIS-II conventions, I-I 

program development examples, 1-2 

prompts, I-l 

related publications, 1-2 

software version compatibilities, I-l 
Series IV information, 

continuation-line characters, K-1 

environmental considerations, K-1 

iNDX conventions, K-1 

pathnames, K-1 

program development examples, K-2 

prompts, K-1 

related publications, K-2 

software version compatibilities, K-2 



size, 5-17 
SM, 5-3,5-11 
SS, 

L1NK86, 2-23 

LOC86, 5-17 
ST, 5-18 
START. 5-18 
start address, 5-4, 5-18 
SYMBOLCOLUMNS, 

L1NK86, 2-25 

LOC86, 5-20 
SYMBOLS, • 

in OBJECTCONTROLS, 
LINK6, 2-14 
LOC86, 5- 10 

in PRINTCONTROLS, 
L1NK86,2-18 
LOC86, 5-13 

LINK86, 2-24 

LOC86, 5-19 
symbol table, 

LINK86, 2-25, 2-29 

LOC86, 5-20, 5-21 



THEADR, A-5 
TITLE, 3-6 
TT, 3-6 
TY, 2-26 
TYPE, 

in OBJECTCONTROLS, 2-14 
in PRINTCONTROLS, 2-18 
LINK86 control, 2-26 
type checking, 2-26 



variable name, 2-4 
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